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Safety Considerations 



Review the hardware documentation to become famihar with safety 
markings used on the product. The following list shows some of the 
safety symbols used to indicate various safety considerations. 



SAFETY SYMBOLS 



A 



^ 



Instruction manual symbol. The product will be 
marked with this symbol when it is necessary for the 
user to refer to the instruction manual in order to 
protect the product against damage. 

Indicates hazardous voltages. 



Indicates earth (ground) terminal (sometimes used 
in manual to indicate circuit common connected to 
grounded chassis). 



Warning 



e 



The WARNING sign denotes a hazard. It calls 
attention to a procedure, practice, or the Mice, 
which, if not done correctly or adhered to, 
could result in injury. Do not proceed beyond a 
WARNING sign until the indicated conditions are 
fully understood and met. 



Caution 



• 



The CAUTION sign denotes a hazard. It calls 
attention to an operating procedure, practice, or the 
like, which, if not done correctly or adhered to, could 
damage or destroy part or all of the product. Do not 
proceed beyond a CAUTION sign until the indicated 
conditions are fullv understood and met. 
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HP-UX Basics 



Introduction 

This handbook provides fundamental reference information about the 
HP-UX operating system. 

The information presented here is in abbreviated format, and is, 
largely drawn from course instruction materials in HP-UX System 
Administration as presented by the Systems Support Training 
Department of Systems Support Division. 

Users of this handbook are encouraged to seek other sources of 
information to acquire a broader understanding of HP-UX. The 
handbook is not a substitute for formal training, or self-initiated 
learning about HP-UX. Rather, it is assumed that to use this 
handbook, you will already be knowledgeable of basic HP-UX 
operating system principles. 
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HP-UX Directory Structure 



Directory Name 


Contents and Use 


/ 


Root 


/bin 


Public commands 


/dev 


Special device files 


/etc 


Commands and files for system administration 


/etc/conf 


Contains object code for driver generation and 
system configuration 


/etc/conf/gen 


Contains the S800 file 


/etc/newconfig 


Contains new versions of configuration files and 
scripts after an update 


/lib 


Contains object code libraries and related utilities 


/hp-ux 


Contains the HP-UX operating system (kernel) 


/tmp 


Contains temporary files and system panic 
information 


/mnt 


User home directories 


/usr 


Contains less frequently used commands and 
miscellaneous files 


/usr/lib 


Overflow for /lib 


/usr/mail 


Mail directory used for depositing mail files 


/usr/man 
/ man 1.. man 8 


Contains unformatted man pages 


/usr/man/catl.. 
ca.t8,catlm 


Contains formatted man pages 


/usr/spool 
/uucppublic 


Used for free access of files by other systems (uucp 

and LAN) 
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HP-UX Dh-ectory Structure (continiMd) 



Directory Name 


Contents and Use 


/usr/spool 


Spooled (queued) files for various programs 


/usr/spool/uucp 


Queued work files, lock files, log files, etc. for uucp 


/usr/tmp 


Alternate place for temporary files 


/usr/contrib 


Contains contributed files and commands 


/usr/contrib/bin 


Contains user contributed commands 


/usr/contrib/lib 


Contains contributed object libraries 


/usr/contrib 
/man 


On-line documentation for any contributed files 


/usr/news 


Contains news items about customer's system. 


/usr/diag/bin 


On-line diagnostics 


/usr/include/sys 


Low level (kernel related) C language header files 


/usr/lib/uucp 


Configuration files for uucp 


/usr/adm 


System administrative data files 
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Command Structure 

$ command [options] [parameters] 

■ White space is used by HP-UX as the deUmiter between the 
command, any options, or parameters. 

■ Most commands have several options. 

■ Most commands require at least one parameter. 

■ Example: 

Is -a /mnt/users/stuOl 



Full Path Names 

■ Full path names always begin from the root (/) directory. 

■ Full path names ALWAYS start with a / (slash). 

■ Examples: 

/etc/conf/gen/S800 

/etc/mount 

/mnt/users/stuOl 
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Relative Path Names 

■ The path specified is with reference to the directory where you 
currently reside in the hierarchical file system. 

■ Use the HP-UX pwd command if you are unsure of your location in 
the file system. 

■ Relative path names must begin with one of the following: 



Metacharacter 
or Name 


Meaning 




Path begins with current directory. 




Path begins with parent directory. 


filename or 
subname 


Path begins at the current directory with 

the file filename, or the subdirectory named 
subname. 
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HP-UX Commands 



File Commands 



HP-UX File Commands 



Command 


Description 


more file2 


Displays the contents of file2 on screen 


q 


Quits display and returns to command line 
when using more command 


RETURN 


Displays one more line when using more 
command 


SPACE 


Displays another screen when using more 
command 


h 


Displays help menu when using more command 


cat filel 


Displays the contents of filel on screen 


cat > newtest 


Takes whatever is typed at the terminal and 
puts it into the new file newtest until Ctrl-d is 
typed 


cat >> oldtest 


Takes whatever is typed at the terminal and 
adds it to the end of the existing file oldtest 
until Ctrl-d is typed 


cat filel file2 > fileS 


Combines filel and fileS and puts them in fileS 
with fileJ first 


grep pattern file4 


Displays the lines in which the string pattern 
occurs in fil€4 


cp file5 filenew 


Makes a copy of the file file5 in filenew. If 
filenew is a directory, a copy of filed is put in 
that directory. 


mv blue green 


Changes the name of the file blue to green. If 
green is a directory, the file blue is moved into 
it. 
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HP-UX File Commands (continued) 



Conunand 


Description 


rm useless 1 useless2 


Deletes the files uselessl and useless2 


Ip file6 


Sends the file filed to the default system line 
printer 


vi file? 


Creates or edits the file file? with the vi screen 
editor 


cmp filel file2 


Does a binary compare oi filel and file2 


diff filel file2 


Displays the difference between ASCII filel and 
ASCII file2 on screen 


chown stuxx filel 


Changes ownership of file filel to stuXX 


chgrp ces files 1 


Changes the group ID oi filel to ces 


chmod 755 filel 


Changes the (r)ead-(w)rite-(e)xecute file 
permissions, for owner-group-other, of file filel 
to rwxr-xr-x 
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Directory Commands 

HP-UX Directory Commands 



Command 


Description 


Is 


Lists the files and subdirectories of the current 
directory 


Isf 


Lists the files and subdirectories of the current 
directory; flags directories with a (/) and 
executable files with a (*) 


11 


Long listing of the current directory; shows file 
type, permissions, ownership, size, etc. 


Issf /dev/* 


Displays all device files in /dev\ shows physical 
addresses and file descriptions (S800 only) 


file* 


Lists all files in current directory and attempts 
to show file type 


pwd 


Displays the name of the working directory on 
screen 


cd 


Returns you to your home directory 


cd /user/stuOl 


Moves you to the directory /user/stuOl 


cd.. 


Moves you to your working directory's parent 
directory 


mkdir servicenotes 


Creates a new subdirectory in your current 
directory named servicenotes 


rmdir letters 


Deletes the directory letters, if the directory 
contains no files 


rm -r * 


Recursively removes all files in the current 
directory (know what directory you are in 
before typing this command). 


find / -name 

"*cat*" 


Searches all mounted file systems for a file name 
which includes the pattern cat anywhere in it. 
Once found, find displays the path name 
associated with the file 



HP-UX Basics 1-9 



System Commands 

HP-UX System Commands 



Command 


Description 


who 


Displays the users currently logged onto the 
system and the ports used 


who -r 


Displays the current system run-state 


ps -ef 


Displays all processes executing on the system; 
shows PIDs, PPIDs, etc. 


man Is 


Displays information about the Is command and 
its options 


man -k mail 


Lists the HP-UX commands that relate to the 
keyword mail 


kill 4507 


Terminates the process associated with process 
ID number 4507 


exit 


logout 


bdf 


Shows disk usage and percentage full 


diskinfo 
/dev/rdsk/cld0s2 


Displays model number of disk associated with 
disk special file /dev/rdsk/cld0s2 


Ipstat -t 


Shows status of spooler 


write 


Writes to users already logged on to system 


wall 


Broadcasts system wnde announcement to all 
users 


echo message 


Echoes ASCII message message on screen 
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HP-UX System Commands (continued) 



Command 


Description 


init s 


Changes run-state from multiuser to single user 


init 2 


Changes run-state from single user to multiuser 


mount 


Lists what file systems are mounted 


mount -a 


Attempts to mount all file systems listed in 
/etc/checklist 


umount 
/dev/dsk/cldOsll 


Manually unmounts /dev/dsk/cldOsll file 
system 


cd /dev; insf 


Assigns logical unit number{s) to new device(s) 
found by ioscan. Makes device files for new 
device(s). 


cd /dev; insf-e 


Remakes device files for existing devices 


ioscan -f 


Probes hardware. Binds drivers to hardware if 
the drivers are present in the kernel. Lists 
resulting hardware and path information. 


ioscan -kf 


Does not scan hardware. List hardware and 
path information for devices known to the 
kernel. 


rmsf -H 
BC/X.Y.Z.U 


Removes device file(s) and logical unit number 
assignment in the kernel for a device on path 
BC/X.Y.Z.U 


cd /dev; insf-H 
BC.X.Y.Z.U -1 lu 


Assigns logical unit number lu to device at path 
BC.X.Y.Z.U . Makes device file for this path. 


tset hp2392 


Initialize hp2392 terminal. Sets backspace, tabs, 
etc. 


suplicen 


Installs a diagnostic password. Valid until user 
logs off. 


swapinfo 


Displays where system can swap 
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Command Keys 



HP-UX Command Keys 



Command 


Description 


Ctrl-c or DEL 


Interrupt. Stops a command from being 
executed 


Ctrl-d 


Removes you from the current environment. At 
the $, #, or % prompts, these keys log you off 
the system (if you are in your primary shell) 


Ctrl-s 


Temporarily stops output to the display 


Ctrl-q 


Resumes the output that was halted by Ctrl-s 



Wild Card Characters 

HP-UX Wild Card Characters 



Command 


Description 


* 


Designates all files in the current directory 


s* 


Designates all files beginning with s in the 
current directory 


*.c 


Designates all files ending with .c in the current 
directory 


???? 


Designates any 4-character filename in the 
current directory 


s??? 


Designates any 4-character filename beginning 
with s in the current directory 
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c 

X 
n> 



c* 



c 
3 



3 

3 
a> 

3 

a 



□ Lists the contents of a 


directory or file in long format 






Example listing for ord 


nary or 


directory files: 








# II / 












-rwxr-xr-x, 
drwxr-xf-x 
drwxr-xr-x % 


1 

2 
3 

of 

(S 


root 
root 
root 


root 1509376 
other 4©96 
other 4096 


Feb 3 18:06 
Feb 3 17:10 
Feb 3 17:36 

time of last 
modification 


hp-ux 

bin 

system 




mode # 
linf 


1 
owner 


group size 
byt 


in 

9S 


file 
name 




Example listing for special device files: 








# II /dev/tty1pO 












crw — w — w- 1 




root 
owner 


root 1 


/)x000100 


Feb 3 


17:47 


/dev/tty1p0 


mc 


)de # 
lin 


of 

«;s 


1 

group major 
number 


1 

minor 
number 


time of 
modifica 


ast 
tion 


file 
name 
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3/89 



o 

o 
3 
3 

3 

a 



c 

X 

DD 
&) 
in 



•n 



c 
tf) 
5" 



To invok*: vi filename 






V,MooE,/ -^ MODS / one command 
— ', _ — ^*- ESC -^i^-^^^ ^-— ** — auto return 


/'^'^~^'^\ wq filename 

( M^DE r^ °^ 

^_- ^yZZ^ q' '^0 ^bort) 












TEXT ENTRY MODE 


COMMAND MODE 


EX MODE 




a - Append after cursor 


U - Restore line to original state 


Global Search/Replace: 




i - Insert l)efr>re !;ursf>t 


u - Undo last command 


g/str1/s/str1/str2/ - Find line(s) 






- Open new line after cursor 


Deleting Text: 


containing 'str', replace first 






- Oppii nev/ line liefoie cursor 


dd - Delete line at cursor (ndd rjeletes 'n' lines) 


pattern 'strl' on that line 






ESC - Ends text entry mode 


X - Delete character at cursor 

dw - Delete word at cursor 

r - Replace character it cursor 

('r' deletes char; next char typed leplaces) 
Cursor Movement: 

h - left J - down k - up 1 - right 

Search: 

/pattern - Forward search for 'pattern' 
n - Search forward again for 'pattern' 
N - Search backward again for 'pattern' 

Copy Line(s}: 

riY - Yank 'n' lines into butter (start at cursor) 
P - Put y.jnked lines above current cursor 
position 


with 'sfr2' 
Save Text and Exit: 

wq or X - Save file then exit 
Write Text to File: 

w filename - Write to 'filename' 
Overriding Protection: 

cmd! - ! following ex command 
overrides vi or file protect 
(you must be superuser) 

examples: 

w! - writes to protected file 
ql - quits without forcing 
write (aborts vi) 
Position Cursor to Line Numt>er 

# - '#' is desired integer line number 






urixAorio 
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c 


m 


(l» 


a 


3 


■ma 


IQ 


O 


<. 


(0 



ed in Review 

• Modifying Text Within a Line 

s/old pattern/new Substitutes first occurrence of old pattern in a 
pattern/ line with new pattern. 

s/old pattern/new Substitutes all occurrence of old pattern in a 
pattern/ g line with new pattern. 

• Moving Lines 

General format: x,ymz 

X Beginning line argument. 

y Ending line argument. 

m Move command. 

z Destination argument (followed by the number of lines 

to move). 

Example: 3,10m50 

Lines 3 through 10 move after line 50 (lines,are 
automatically renumbered after the move). 

• Searching a File for a Pattern 

/pattern/ Forward Search. 

^pattern? Backward Search. 

/'pattern/ Search forward for a pattern beginning a line. 

/patterns/ Search forward for a pattern ending a line. 
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• Making Commands Effective Globally 

General format: g/paUem/command list/g 

X Beginning line argument. 

y Ending line argument. 

g Global command informs ed to perform command 

list on every line containing pattern in the file. 

command list List of ed commands to be performed on first 
pattern match on each line. 

g Informs ed that the command list is to be 

performed on all pattern matches on line. 
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• Line Arguments 

General format: x,y command list 

X Beginning line argument. 

y Ending line argument. 

command list List of ed commands to be performed. 

o Common Arguments 

Current line. 



+ 



/pattern/ 

Examples: 

i, ^command 
list 

i,^-<? command 
list 



Move forward one line. 
Move back one line. 
Move to last line in file. 
Move to first line in file. 
Forward search for a pattern. 

Perform command list on all lines in a file (same as 
g argument in Making Commands Effective 
Globally). 

Perform command on all lines except last four. 



/HP/, /products/ Performs commands on all lines beginning with 
command list pattern HP and ending with line containing 
products. 
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• Invoking ed 

$ ed 

$ ed oldfile 

• Basic Commands 

a Append lines of text after current line (single period 

<•> at beginning of a line ends append mode). 

i Insert lines before current line (single period <.> at 

beginning of a line ends insert mode). 

d Delete line of text at cursor. 

p Print line. 

g Perform command list on selected lines of entire file. 

s Modify text on a line by substitution. 

m Move line(s) to new position in file (lines are 

renumbered after move. 

n Print line number of current line. 

r Read specified file into current line after the addressed 

line. 

h Terse help message. 

u Undo last command. 

w Write ed buff"er to specified file (for example w newfile). 

q Quit ed. 

qq Abort ed without writing. 
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HP-UX Processes 



stdjn 



(normally keyboard) 



UNXA0131 



HP-UX 


— ^ stdout 


PROCESS 


(normally user's display) 




—— stderr 




(normally user's display) 




3/89 



Work in HP-UX is accomplished within a process. A unique process 
is created for each command or program executed. 

Process I/O. 

n Input is taken from the standard input file (stdin). 

□ Output is directed to the standard output file (stdout). 

D Any errors generated are directed to standard error file (stderr). 

Each process has a unique Process ID (PID) number to identify the 
process to the HP-UX kernel. 
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Observing Process Status 

• Use ps -ef to Display all System Processes 
$ps -ef 



UID 


PID 


PPID 


C 


STIME 


TTY 


TIME COMMAND 


root 


89 


1 





Nov 18 


console 


0:00 -sh 


root 


3 








Nov 18 


7 


0:01 statdaemon 


root 


2 








Nov 18 


? 


0:00 pagedaemon 


root 


1 








Nov 18 


? 


1:40 init 


root 











Nov 18 


7 


0:04 swapper 


root 


5965 


89 





09:28:30 


console 


1:00 ps ef 


root 


5964 


89 





09:27:58 


console 


0:00 sleep 100 



Field 


Meaning 


UID 


User ID 


PID 


Process ID 


PPID 


PID of parent process that spawned this process 


C 


Processor utilization for scheduling 


STIME 


Starting time of process. Displays date if >24 hours 


STTY 


Sets or displays terminal I/O options 


TIME 


Cumulative CPU execution time in minutes and 
seconds 


COMMAND 


Nearest approximation of command typed that fits field 
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Use ps to Display all User Processes $ps 

PID TTY TIME COMMAND 

89 tty0p2 0:00 sh 

5960 tty0p2 0:00 ps 



Field 


Meaning 


PID 


Process ID 


TTY 


Terminal process started on 


TIME 


Cumulative CPU execution time in minutes and 
seconds 


COMMAND 


Nearest approximation of command typed that fits field 
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Redirecting I/O 



stdin 



(file descriptor 0) 



HP-UX 
PROCESS 



UNXA0135 



stdout 

(file descriptor 1) 

stderr 

(file descriptor 2) 
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Redirecting Standard Output. 

D Use > or 1> to create or overwrite the specified output file. For 
example: Scat file > newfile 

n Use >> or i>> to append output to the end of the specified 
output file. For example: $ cat file >> appendedfile 

Redirecting Standard Error. 

n Use 2> to create or overwrite the specified error file. 

For example: Scat file 2> errorfile 

a Use 2>> to append error output to the end of the specified error 
file. For example: Scat file 2» errorlogfile 

Redirecting Standard Input. 

n Use < or 0< to accept input from the specified input file. For 
example: Smatl < formletter 
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Running a Process in the Background 

■ Use the & (ampersand) character following the command, 
options, and arguments to place a process in background. 



$sle€p 90 & 
5964 

$ 




$ps 




PID TTY 


TIME COMMAND 


89 tty0p2 


0:00 sh 


5968 tty0p2 


0:00 ps 


5964 tty0p2 


0:00 sleep 90 



Use kill along with the Process ID number to terminate a process 
before it completes execution. 

$ktll 5964 



Connecting Processes with Pipelines 

■ Pipelines connect the standard output (stdout) of one process to 
the standard input (stdin) of another process. 

■ The symbol | (vertical bar) is the pipe symbol. The standard output 
of the process to the left of | becomes standard input to the process 
on the right of | . 

■ The HP-UX kernel handles necessary buffering. 

■ Examples: 

$who I wc -I Counts the number of users on the system. 

$ls -alR / \ wc -I Counts the number of files on the system. 

%cat /etc/passwd \ Ip Directs /ttc/passwd to the default line 

printer. 
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Filters 

■ Filters take input, perform some filtering action, and finally output 
data according to the filtering criteria. 

■ Examples: 

D $(/rep stuOl /etc/passwd 

stu01:aq3jpzX:201:200::/mni/users/stu01:/hin/sh 

Grep examines all lines in /etc/passwd. Lines not containing 
stuOl are filtered out. 

a $who I sort 



stuOl ttyOpl Jul 20 15 
stu02 tty0p5 Jul 20 11 
stu04 ttylpO Jul 20 08 



48 
32 
31 



Sort filtered who output into alphabetical order by login name. 
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HP-UX Login Process 

1. /etc/getty 

■ Prints /tic/issue at logoff. 

■ Issues login prompt (uses /etc/gettydefs). 

■ Reads login name. 

■ Invokes /bin/login command. 

2. /bin/login 

■ Checks login name and password (uses /etc/passwd). 

■ Updates accounting files. 

■ Sets working directory. 

■ Invokes command given in last field of user entry in /eic/passwd. 

3. Initialize Shell 

■ Bourne Shell (/bin/sh). 
m C Shell {/bm/csh). 

■ Korn Shell (/bin/ksh). 

m Restricted Shell {/bin/rsh). 
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The /etc/gettydefs File 

• Fields: label # initial-flags # final-flags # login-prompt # next-label 

Where: 

label - Identifies the entry. 

- Matches against "getty" speed argument. 

Initial line and terminal settings (speed must be 



tmtial-flags 
final- flags 



specified). 

- Final line and terminal settings (speed must be 
specified). 

login-prompt - Initial login prompt printed on the terminal. 

next- label - Entry to try next if "break" is typed. 



The /etc/passwd File 
• Fields: 

user^name:passwd:user_id:group_id:comment:login_dir:cmd 
Where: 

user_name - User's login name. 

password - User's password in encrypted form. 

- Optional password aging sub-field. 
user^id - Unique integer value between 1 and 6000. 

- If user_id is zero, user has superuser capabilities. 
group ^id - Integer value identifying the group. 

comment - Users full name and other ID information. 

logtn^dir - Full path to user's login directory. 

cmd - Command to execute at login. 

- Usually a shell is invoked. 

- Default is /bin/sh. 
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The /etc/group File 
• Fields: 

group_name:password:group_id:members 
Where: 

group^name - Contains the name of the group. 

password - Generally not used and usually remains null. 

group_id - Unique integer value identifying the group. 

members - Comma separated list of members in the group. 

- List of users who can change to the group with 
newgrp. 
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Shell initialization 

■ /hin/login invokes the user's shell. The three shells most frequently 
used are the Bourne Shell (/bin/sh), C Shell {/bin/csh), and Korn 
Shell i/btn/ksh). 

■ Once invoked, each shell executes customized scripts to set up the 
global user environment, and any user-created local environment. 

The initialization flow is illustrated below: 



Shell 

shell proaram 

1 " 

Clobal script 



Bourne Shell 

/bin/sh 

1 

/etc/profile 



C Shell 

/bin/csh 

I 

/etc/csh.logii 



local user scriptis) $HOME/.profile -/.cshrc^ 



executed each time 
a subshell is spawned 



-/.login 



Korn Shell 

/bin/ksh 

1 

/etc/profile 

I 
^$HOME/.kshrc 

1 
$HOME/.profile 



-/.logout —executed at — $HOME/.logOUt 

'logout' 
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Bourne Shell 

The /etc/profile File 
Example: 



# @(#) SRevision: 66.6 $ 

# Default (example ofi system-wide profile file {/bin/sh initialization). 

# This should be kept to the bare minimum every user needs. 


trap •■123 


# ignore HUP, INT, QUIT now. 


PATH=/bin:/usr/bin-./user/contrib/bin;/usr/local/bin 
MANPATH=/usr/man:/usr/contrib/man:/usr/local/man 


# default path 

# default path 


if [ -r /etc/src.sh ] 
then 

. /etc/src.sh 

unset SYSTEM NAME 
else 

TZ=MST7MDT 

export TZ 
fi 


# set the timezone 

# change this for local time. 


If [ 'STERW = ■ ■ j 
then 

TERM=hp 

fi 


# if term is not set, 

# default the terminal type 


export PATH MANPATH TERM 




# Set erase to "H 




stty erase 




# Set up shell environment: 




trap 'echo logout' 




# This is to meet legal requirements . . . 
cat /etc/copyright 
if [ -r /etc/motd ] 
then 

cat /etc/motd 
fi 


# message of the day 


if [ -f /bin/mail 1 
then 

if mail -e 

then echo 'You have mail.' 

fi 


# notify if mail. 


fi 

if [ -f /usr/bin/news ] 

then news -n 

fi 


# notify if new news. 


if [ -r /tmp/changetape ] # might wish to delete this, 
then echo ■\007\nYou are the first to log in since backup:' 


echo 'Please change the backup tape.\n' 
rm-f /tmp/changetape 

fi 

trap 1 2 3 




* leave defaults in user environment. 
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Figure 1-4. /etc/profile Example 
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Default Variable Settings 

• Variables set by /hin /login: 

HOME - Contains default argument (login directory) for 

cd, 

command. 
MAIL - Set to the name of the user's mail file. If mail 

arrives in the specified file, the shell notifies the 

user of its presence. 
SHELL - Set to last field of user's /eic/passwd entry 

(normally Shell). 
LOGNAME - First field of user's /etc/passwd entry. 

• Variables Set by the Bourne Shell: 

PATH - Contains the search path for commands. 

PSl - Contains primary prompt string. Default is $ 

(dollar sign). 
PS2 - Contains secondary prompt string. Default is > 

(greater than sign). 
MAILCHECK - A colon (:) separated list of file names. If mail 

arrives in any of these files, the user is notified. 

Overrides MAIL if set. 
IFS - Internal field separators, normally space, tab, 

and newline. 
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Examining Variables with set 

$ set 

H0ME=/mnt/users/stul3 

IFS= 



L O GNA ME=siul 3 

MAIL=/usr/maU/stul3 

MAILCHECK=600 

PATH = /bin: /usr/hin:/usr/contrih/bin:/usr/local/bin 

PS1=$ 

PS2=> 

SHELL=/btn/sh 

TERM=hp 

TZ=PST8PDT 

$ 

A .profile Example 



# To search your HOME directory: 

PATH=$PATH:/mnt/users/stul3 

if^ To change your primary system prompt: 

PS1='MY NAME: ' 

Note ■ Rather than construct a .profile file, the system 

- administrator is encouraged to copy /etc/d. profile 

MB into the user's HOME directory. The user can 

■■ customize this script to meet login needs. 

■ To copy the file, type the following: 

$ cp /eic/d.profile $HOME/.profile 
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C Shell 

The /etc/csh. login File 
Example: 



# Default (example ofl system-wide profile file {/bin/csh initialization 

# This should be kept to the bare minimum every user needs. 




# default path for all users 

set path=(/bin /usr/bin /usr/contrib/bln /usr/local/bin) 

set prompt='^!] % ' 




# default MANPATH 

setenv MANPATH /usr/man:/usr/contrib/man:/usr/local/man. 




if ( -r /etc/src.csh ) then 
source /etc/src.csh 

else 

setenv TZ MST7MDT 

endif 


# set the TZ variable 

# change this for local time. 


if ( ! $?TERM > then 

setenv TERM HP 
endif 


# if TERM is not set, 

# use the default 


# This is to meet legal requirements . . . 




cat /etc/copyright 


# copyright message 


# Miscellaneous shell-only actions 




if { -f /etc/motd ) then 

cat /etc/motd 
endif 


# message of the day. 


if ( -f /bin/mail ) then 
mail -e 


# notify if mail. 


if ( Sstatus == ) echo 'You have mail." 
endif 




if ( -f /usr/bin/news ; then 

news -n 
endif 


# notify if new news. 


it ' -• .'tmp/cnangetape ' then 
echo 

echo 'You are the first to log in since backup:' 
echo 'Please change the backup tape.\n' 


* might wish to delete this : 


rm -f 'tmp/changetape 
enaiT 
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Figure 1-5. /etc/csh.login Example 
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The ~/.cshrc File 



# Default user .cshrc file ( /b 


n/csh initia 


ization ) 




# Usage: Copy this file to a 


user's 


home directory and edit it to 




# customize it to taste, it is 


run by 


csh 


each time it starts up. 




# Set up default command se 


arch pa 


th: 






set path=( /bin /usr/bin 










# Set up C shell environment: 










if ( $?prompt ) then 






# shell IS interactive. 




set historv-20 






# previous commands to 


remember. 


set savehist=20 






# number to save across 


sessions. 


set system='hostname' 




# name of this system. 




set prompt = "$system \!: " 




# command prompt. 




# Sample alias; 










alias h 


History 








# More sample aliases, commer 


ted out by default: 




# alias d 


dirs 








# alias pd 


pushd 








# alias pd2 


pushd +2 






# alias po 


popd 








# alias m 


more 








endif 
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Figure 1-6. The ~ /.cshrc File 
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The y .login File 



# Default user .login file ( /bin/csh initialization ) 

# Set up the default search paths: 

set path=(. /bin /usr/bin /usr/contnb/bin /usr/local/bin) 

# set up the terminal 

eval 'tset -s -Q -m ':?hp' ' 

stty erase "^H" kill ""U" intr "X" eof "'D" 

stty hupcl ixon ixoff 

tabs 

hp9000s800 # Job control available on hp9000s800 only 

if ( "$status" == "0" ) then 

stty sup "~Z" tostop 
endif 

# Set up shell environment: 
set noclobber 

set history=20 
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Figure 1-7. The '/.login File 
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Setting up C Shell history Command 

■ The following sets up the C Shell history command: 

□ To set the size of the history event buffer (this is normally done 
by the ~/.cshrc file at login): 

% set history = iistsize 

(where Iistsize is an integer between 10 and 20) 

n To set the number of events to be saved at logout and restored on 
login (this is normally done by the ~/.cshrc file at login): 

% set savehisi — Iistsize 

(where Iistsize is an integer between 10 and 20) 

n Set the login prompt to reflect history event numbers (this is 
normally done by the ~/.cshrc file at login): 

% set prompt — '*/\/7 %" 

a To save typing, alias the history command to h (this is normally 
done by the ~/.cshrc file at login): 

% alias h history 

Examining the history Event Buffer 

■ The user's command sequence: 

[1]% Is 

testfile filel file2 

[2]% pwd 

/mnt/users/stuOl 

[3]% mv tesfile testfile. bak 

mv: tesfile : Cannot access : No such file or directory 

[4J% 

m To view the event buffer: 

[4]% history 

1 Is 

2 pwd 

3 mv tesfile testfile. bak 

[5]% 



HP-UX Basics 1-35 



Reusing Commands in the Event Buffer 

■ An explanation mark (!) is used to reference a command for reuse. 

■ The examples shown below assume the following event buffer 
contents: 

[4]% history 

1 Is 

2 pwd 

3 mv tesfile testfile.bak 

4 history 
[5]% 

■ Referencing and executing the last command using two explanation 
marks (!!): 

[5]% a 

history 

1 Is 

2 pwd 

3 mv tesfile testfile.bak 

4 history 

5 history 
[6]% 

■ Referencing and executing a buffer event using an explanation mark 
(!) and the event number: 

[6]% !1 

Is 

testfile filel file2 

[7]% 

u Referencing and executing a buffer event by using an explanation 

mark (!) and a relative location number: 

[7]% 1.-3 

Is 

testfile filel file2 

[8]% 
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■ Referencing and executing a buffer event by using and explanation 

mark (!) and event text: 

[8]% !p 

pwd 

/mnt/users/stuOl 

Modifying Previous Events 

■ Correcting the previous event: 

Syntax: oldstring newstring (to replace oldstnng with newstrtng; 
omit the final circumflex ( ) when a carriage return is used). 

Example: 

[1]% Is 

iesifile filel fHe2 fikSO 

[2]% mv tesfile testfik.bak 

mv : tesfile : Cannot access : No such file or directory 

[3J% 'tesfile 'testfik.bak 

[4]% mv testfik.bak 

[5J% 

■ Correcting an event by string substitution: 

Syntax: !listnumber:s/oldstring/newstring (to substitute the first 
occurrence of oldstring with newstrtng). 

Example: 

[1J% Is 

testfik filel file2 fileS 

[2]% mv tesfile testfik.bak 

mv : tesfile : Cannot access : No such file or directory 

[3]% pwd 

/mnt/users/stuOl 

[4]% !2:s/tes/test 

mv testfik.bak 

[5]% 
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Correcting an event using global string substitution: 

Syntax: !listnumber:gs/oldstring/newstring (to substitute all 
occurrences of oldstring for newstring). 

Example: 

[1]% Is 

iesifile file 1 file 2 files 

[2]% mv tesfile testfile.bak 

mv : tesfile : Cannot access : No such file or directory 

[3]% pwd 

/mnt/users/stuOl 

[4]% !2:gs/tes/test 

cp testfile.bak 

[5]% 



Modify an Event and Print Without Execution 

■ Printing a modified event without execution: 
Syntax: !listnumber:p:modification_command(s) 
Example: 

[4]% history 

1 Is 

2 pwd 

3 mv tesfile testfile.bak 

4 history 

[5]% !3:p:s/esf/estf 
mv testfile.bak 
[6]% history 

1 Is 

2 pwd 

5 mv tesfile testfile.bak 

4 history 

5 mv testfile.bak 

6 history 
[7]% !5 

mv testfile.bak 
[8]% 
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Booting 

Initial System Load (ISL) 

■ Must reside in Section 6 of boot device. 

■ Operatmg system independent. 

■ Used to set default boot paths. 

■ Used to load the HP-UX kernel. 

■ Diagnostic information: 

□ Error messages on console. 

n Error codes on display panel. 

n See ISL(IM) for message detail. 

D See hpux_800(lM). 



HP-UX Basics 1-39 



ISL> help 



7 

HELP 

LISTF 

LS 

AUTOBOOT 

AUTOSEARCH 

PRIMPATH 

ALTPATH 

CONSPATH 

DISPLAY 

LSAUTOFL 

LISTAUTOFL 

FASTSIZE 

SUPPORT 

SUPPORTCD 

READNVM 

READSS 

LSBATCH 

LISTBATCH 

BATCH 

LSEST 

LISTEST 

EST 



Help facility 

Help facility 

List ISL Utilities 

List ISL Utilities 

Set or clear autoboot flag in stable storage 

Set or clear autosearch flag in stable storage 

Modify primary boot path in stable storage 

Modify alternate boot path in stable storage 

Modify system console path in stable storage 

Display boot and console path in stable storage 

List contents of autoboot file 

List contents of autoboot file 

Sets or displays FASTSIZE 

Boot the Support Tape from the boot device 

Boot the Support Tape from the CDROM 

Display contents of one word of NVM 

Display contents of one word of stable storage 

List the contents of batch file 

List the contents of batch file 

Execute commands in the batch file 

List the contents of EST (Extended Self Test) file 

List contents of EST (Extended Self Test) file 

Execute commands in EST (Extended Self Test) file 



Utilities on this system are: 

HPUX 

RDB 

lOMAP 



Utilities on the Support Tools Media are: 



RECOVERY 
CLKUTIL 

A1002AI 

A1002AP 

Al 100AM 

EDBC 

MPROC 

TDIAG 



SS_CONFIG 

BCDIAG 

A 1002 AM 

AllOOAI 

AllOOAP 

EDPROC 

MULTIDIAG 

UNIPROC 
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ISL> hpux Utility 

ISL>hpux (BC/X. Y.Z. U;S)kernelfile 

Use for normal system start-up. 
ISL>hpux set autofile "hpux (BC/X.Y.Z.U;S)kemelfile" 

cse to Ciiange tue uoot String in auuonie. 

ISL>hpux -Im (BC/X. Y.Z. U;0)kernelfile 

Use to perform maintenance (will not boot) boot on LVM boot 
disk. 

ISL>hpux -Iq (BC/X. Y.Z. U;0)kernelfile 

Use to override root volume group quorum requirements when 
booting an LVM bootable disk. 

ISL>hpux -a(C\R\S\D)devicefil€ (BC/X.Y.Z.U;S)kem.elfile 

Use to override kernel device(s) (console, root, swap, and dump). 
ISL>hpux -IS (BC/X. Y.Z. U:S)kemelfile 

Use if root password lost or start-up files are suspect. 
ISL>hpux Is (BC/X. Y.Z. U;S)/[path] 

Use to look for a kernelfile on the specified path. 
ISL>hpux -m[p\s\xj (BC/X. Y.Z. U;S)kernelfik 

Use to boot from opposite side of mirrored root. 
IS L> hpux -F 

Use with SWITCHOVER/UX to ignore locks. 

NotG Parameters for the ISL hpux utility are described on 

the following two pages. 



4 
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Where: 



Key 

kemelfile 

set autofile 
Im 



k 

devicefile 

-a{C\R\S\D) 



Is 

path 
BC/ 



X 

y 



Description 

Name of kernel to be loaded (typically hp-ux or 

SYSBCKUP). 

Sets autofile to the string enclosed in double quotes. 

Boot LVM boot disk from known off"set of LVOLl 

without using information in the Boot Data Reserve 

Area (BDRA). Useful if normal boot fails because of 

BDRA corruption. 

Boot LVM bootable disk without meeting quorum 

requirements. 

Hardware path of kernel device. 

Configure the device as console, root, swap, or dump 

device, for example the boot string: ISL> hpux 

-aR(BC/X. Y.Z. U;r) -aS(BC/X. Y.Z. U;s) 

-aD(BC/X. Y.Z. U;d) (BC/X. Y.Z;r)kemelfile overrides 

the existing kernel's kernel devices information 

specifying root on section r, swap on section s, dump 

on section d. The final argument specifies the location 

of the kernelfile. 

Load kernel in single-user mode. Gives superuser 

capabilities on the system console without going 

through /etc/passwd or using /etc/imttab. 

Lists files on the specified path. Executable files names 

are appended with an asterisk (*). 

Path to specified file or directory. 

Bus converter address (PMB or SMB). BC/ is required 

on models 85X/860/87X/890 only. BC/ = 2/ or 6/ 

on 85X/860/87X. BC/ = [(4 x PMB slot#) + 

(interface module #)J on 890. 

MIDBUS or HPPB module number. X = [(4 x 

interface slot number) + interface module number]. 

On CIO machines Y = CIO interface slot number; on 

HPPB machines Y = HPIB, SCSI, or HPFL device 

address. 

HPIB, SCSI, or HP-FL device address 

Integer unit number. Used only for SCSI disk and disk 

arravs. 
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Key Description 

S An integer disk section number which is to be searched 

for kernelfile. 
-m[-p\-s\-xj Boot from opposite side of mirrored root {-mp = boot 

from primary; -ms — boot from secondary). 
-F Use with SWITCHOVER/UX to ignore any locks on 

boot disk. 



Booting HP-UX on HP 9000 Series 600/800 

• From Reset or Transfer of Control 

Boot from primary boot path (Y or N)?> n 

Boot from alternate path (Y or N)?> n 

Enter boot path or ?> BC/X.Y.Z.U (the path to System Disk) 

Booting. 

Console 10 Dependent Code (lODC) revision 4 
Boot 10 Dependent Code (lODC) revision 4 

Interact with IPL (Y or N)?> y 

Hard Booted. 

ISL Revision A. 00. 08 June 22, 1989 

ISL> hpux (BC/X.Y.Z.U:S)hp-ux 
Where: 

Key Operation 

BC/X. Y.Z. U The path to the system disk. See addressing by 
model number for details. 

S Integer disk section number that contains the 

kernel file. For Logical Volume Manager (LVM) 
disks, 6* is always zero (0). For non-LVM file 
systems, S ranges from to 15 (using default 
non-LVM root disk sectioning, S is often 13). 

hp-ux The name of the kernel file (usually hp-ux or 

SYSBCKUP). 
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System Startup 
HP-UX System Startup 

ISL>hpux (BC/X.Y.Z;S)hp-ux 

i 
Loads hp-ux into memorv and then begins execution. 

1 
Kernel invokes /etc/imt command. 

i 
init spawns processes in the order that are listed in /etc/imttab. 
All lines with action fields related to start-up and the default 
run-level are spawned. 

J 
The system completes the startup process. Users may login. 
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/etc/inittab Example 



init:2:iniidefauH: 

ioin::sysinit:/etc/ioinit -iy/'dev/ console > /dev/ console 2>&1 

Tnuxi::sysinit:/etc/dasetup <^/ dev/ console > / dtv/ console 2'>&1 

brcl::bootwait:/etc/bcheckrc <i/dev/ console > /dev/ console 2'>&1 

slih::bootwait:/etc/recoversl <,/ dev/ console > /dev/ console 2>&1 

brc2::bootwait:/ etc/brc y/ dev/ console 2y&l 

link: :wait: /bin/ sh -c "/rm -f dev/syscon; In /dev/systty /dev/syscon' 
> /dev/ console 2>&1^ 

cwrt::bootvjait:cat /etc/copyright >/dev/syscon 

rc::/etc/rc ■^/ dev/ console y dev/ console 2'>&1 

powf::powerwait:/etc/powerfail >dev/console 2>&1 

vue :34:respawn:/etc/vuerc 

cons:. -respawn:/ etc/ getty console 

ttpl :2:respau'n:/etc/getty -h ttyOvl 9600 

ttp2:2:respawn:/etc/getty -h ttyOp2 9600 

ttp3:2:respawn:/etc/getty -h UyOpS 9600 

ttp4:2:respawn:/etc/getty -h ttyOp4 9600 

1 Prints as a single line on the console; no linewrap. 
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/etc/inittab Fields 

inittab format: id:run-level:action:process 

Where: 

Key Operation 

id Unique 1 to 4 character identification. 

run-level Defines when a process is allowed to run. If the system 

run-level matches a process run-level, the process will be 

spawned or allowed to continue running. If the system 

run- level does not match the process run-level, the process 

will be killed. Valid run-levels are through 6 , s, or S. 

Processes can have multiple run-levels, for example, 

id:234:respawn . . . initiates the process to run-levels 2, 3, 

or 4. 
action The options listed below: 

respawn— if process does not exist, start; if process dies, 

restart. 

wait — start the process waiting to complete. 

once — start once, do not wait for completion; if it dies, do 

not restart. 

boot — start once at boot-up; do not wait for completion; 

do not restart. 

bootwait — start once at boot-up; wait for completion; do 

not restart. 

powerwait — execute only when init receives a power fail 

signal (SIGPWR). 

off — if process associated with this entry is running, send 

a 20 second warning signal, then kill the process. 

imtdefault — invoke first time tmt is run. Sets default run 

level. 

systnit — execute before tmt tries to access console. Used 

to initialize devices that tnit could receive run-level 

information from. 
process This is the command to be executed. 
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/etc/inittab Start-up Process Flow 

■ Sets the system run-level as indicated by tmidefault . 

imt: 2:tnitdefault: 

m Runs /etc/ioinit command. Assigns output and error messages to 
the console, ioimt initializes Kernel I/O System data structures 
using information from the /etc/ioconfig file. The -i option causes 
loimi to run /eic/msf in order to assign logical unit numbers (lu) 
and create special device files for all the new devices on the system. 

ioin::sysinit:/eic/ioinit -i >/dev/ console 2>&1 

■ Turns on all multiplexer cards. Assigns input from console, output 
to console, and directs errors to console. 

muxi::sysinit:/etc/dasetup < /dev/console >/dev/console 2>&1 

■ Run /etc/bcheckrc shell program. Assign input, output, and error 
messages to the console, bcheckrc exits if running on a diskless 
client, starts mirror disks if configured, and invokes fsck on dirty file 
systems. 

brcl::bootwait:/etc/bcheckrc </ dev/console > /dev/console 2>&1 

■ Run /eic/recoversl shell program. Assign input, output, and error 
to the console), recoversl checks for the existence of shared libraries 
that are critical to the system. If any critical shared library is 
missing or damaged, recoversl assists the system administrator in 
recovering the shared library from update media. 

slib: :booiwait: / etc /recoversl </ dev / console >/ dev/console 2>&1 

m Run /etc/brc shell program. Assigns output and error messages to 
/dev/syscon. /dev/syscon is used by HP-UX as a virtual system 
console, brc removes the file /eic/mniiab that contains old file 
system mount information. If not running on a diskless client, brc 
removes /eic/rcflag. 

brc2::booiwaii: /eic/brc > /dev/console 2>&1 

■ Remove old /dev/syscon device file. Create new /dev/syscon file 
and link it to /dev/sysity (the physical console). Direct output and 
errors to the console. 

link::wait:/bin/sh -c "/bin/rm -f /dev/syscon; \ 
In /dev/sysity /dev/syscon" > /dev/console 2>&1 
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Display a copyright message on the console for legal purposes. 

cwri::hooiwaU:cat /etc /copyright >/dev/syscon 

Run /etc/rc shell program. Direct output and errors to the console. 
re contains run commands that set date and time, mount file 
systems, and perform other housekeeping chores. 

rc::waii:/etc/rc </dev/console > /dtv/ console 2>&1 

Run /etc/powerfatl shell program. Assign output and error 
messages to the console. 

po'wf::powerwait:/etc/powerfail >/dev/console 2>&1 \ 
#power fail routine 

Create a getty process for the system console. Set up 
communication protocol and issue the first login prompt. 

cons: :respawn:/ etc/ getty console console 

Run HP vue if the system is in run-state 3 or 4. Only XI 1 window 
terminals that have been properly configured for vue will be 
enabled. Processes that are not configured to run in run-state 3 or 4 
will be killed. 

vue :34:respawn:/etc/vuerc 

Create a getty process for each terminal that is to be enabled. Set 
up communication protocol and issue the first login prompt. 

Up l:2:respawn:/ etc /getty -h ttyOpl 9600 
ttp2:2:respawn:/etc/getty -h tty0p2 9600 
ttp3:2:respawn:/etc/geity -h ttyOpS 9600 
ttp4:2:respawn:/etc/getty -h ttyOp4 9600 
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Changing Run Levels with imt 

m The /etc/init command can be used to change the system's run- 
level. 

■ init reads /eic/iniitab only when the run-level changes, or when 
forced to by a. Q or q option. 

■ /etc/inti command and parameters, for example: 

# tnit [0123456SsQqJ 
Where: 

Key Operation 

S I 5 Single user run-level. (Only the virtual console, 

/dev/syscon, is enabled.). 
2 By convention, used as a multi-user run-level. 

Normally used to enable user terminals and other 

serial devices. 
013456 Assigned by system administrator to create other 

run-levels. 
Q I q Forces re-examination of /etc/inittab even if setting 

same run-level. 

Note The default run-level, double colons (::), matches 

run-levels 0-6. 



4 



Example: co::respawn:/etc/getty console console 
(console will remain enabled in run-levels 0-6) 
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The /etc/bcheckrc Script 

■ The bcheckrc script performs the following tasks: 

D bcheckrc determines the type of system invoking this script. If the 
calling system is a diskless cluster, the script is exited. 

n If applicable, mirror disks are configured and fsck is run on them. 

n Check if the mountable file systems listed in /etc/checklist 
were cleanly unmounted on last shutdown. If a file system was 
not cleanly unmounted, fsck is run in preen mode to check for 
corruption. 

n If corruption is detected by fsck and can be repaired without data 
loss, the file system is automatically corrected. If a correction 
could result in data loss, the operator is prompted to run fsck 
interactively to repair the damage; then, to reboot the system 
using the /etc/reboot -n command. 

The /etc/brc Script 

■ The brc script performs the following tasks: 

D The /etc/rcflag flag file is removed if present. This flag is used 
by the /etc/rc script to test if system start-up is occurring. If 
this flag file is absent /etc/rc assumes that the system is in the 
start-up process. 

n brc removes the /etc/mnttab file unless the system being started 
is a diskless client. The /etc/mnttab file contains the file system 
mounting information: /etc/mnttab is updated whenever the 
/etc/rc script is run at system start-up. 
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The /tic /re Script 

■ The re script is divided into two sections: Functions and Function 
Calls. 

n Functions — an example: 

initialize ( ) 

{ 

RBOOTD.DEVICES="" # device file used by /etc/rbootd 
iff "$SYSTEM-NAME"= "" J # system's network name 
then 

SYSTEM_NAME=unknown 

export SYSTEM-NAME 

fi 

TIMEOUT=20 # timeout length for date setting 

vtgateway="" # name of system acting as the gateway 

vtgopts="'' # vtdaemon options 

vtginterfaces=:"" # gateway devices 

} 

localrc ( ) 

{ 

9^ This function is intended for adding local initialization 

functions to re. 

: # do nothing instruction (a function must contain some 

command) 
} 
a Function Call — an example: 
initialize 

localrc 
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/etc/rc Function Calls by System Type 

/etc/rc Function Calls by System Type 





System 






Function Call 


Type 




Basic Tasks Performed 


SAi 


DS2 


DC^ 


hfsmount 


>/ 


y 


V 


Mounts high performance file 
systems 


setparms 


y 


x/ 


V 


Set system configuration values 


initialize 


y 


y 


y 


Set time zone, system name, etc. 


switch_over 


y 


7 


y 


Starts SwitchOver/UX 


set_state 


^/ 


y 


y 


Determine if standalone, server, or 
diskless chent 


set.privgrp 


^/ 


y 


y 


Associate a kernel capability with 
a group id 


set_date 


y 


y 




Set system date, time, and year 


save_core 


x/ 


V 


y 


Saves memory core dump to file 
system files 


swap_start 


v/ 


>/ 


y 


Turn ON paging and swapping 


syncer_start 


y 


y 




Start Synchronizer; flush file 
system memory to disk every 30 
seconds 


lp_start 


V 


y 




Start Ip scheduler if configured 


clean_ex 


V 


y 




Save editor files open during 
power failure 


clean_uucp 


y 


y 




Scan spool directories; delete old 
uucj) files 


net_start 


y 


y 


y 


Start networking 


csp_start 




y 


y 


Start the cluster server 


rbootd_start 




v/ 


V 


Start remote boot daemon for 
diskless cluster 



1 SA = Stcindalone System. 

2 DS = Diskless Server. 

3 DC = Diskless Client. 
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/etc 


/re Function Calls by System Type, cont. 


Function Call 


System 
Type 


Basic Tasks Performed 


SAl 


DS2 


DC^ 


cron_start 


y 


V 


x/ 


Start cron and make new cronlog 


pty_start 


v/ 


v/ 


v/ 


Start pseudo-terminal daemon 


vt_start 


^/ 


v 


y 


Start vtdaemon 


list_tmps 


v/ 


y 


y 


Display files in /imp, /usr/tmp, 
and /lost+found 


clean_adm 


V 


y 


%/ 


Save oldlogs; make sulog, diaglog, 
and messages 


diag_start 


y 


y 


y 


Start diagnostic event logger 


syslogd_start 


y 


y 


v 


Start system error message logger; 
make syslog 


envd_start 


V 


y 


y 


Start environmental daemon 


audit_start 


y 


y 




Start audit subsystem 


localrc 


y 


V 


y 


Run Sys. Admin, created 
initialization commands 



1 SA = Standedone System. 

2 DS = Diskless Server. 

3 DC = Diskless Client. 

The /etc/powerfail Script 

■ The powerfail script performs the following tasks: 

D Runs /etc/src.sh shell program which sets system configuration 
variables such as timezone (TZ) and the system's network name 
(SYSTEM.NAME). 

u Starts multiplexer cards using /etc/dasetup. 

n Logs the fact that a power failure occurred on system console and 
user terminals. 

D If required, the system administrator can add commands to 
reload any programmable I/O card or device needing post failure 
attention. 
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System Shutdown 

The shutdown and reboot Commands 

■ shutdown is the recommended command for halting and rebooting 
the system. The /etc/shutdown script performs the following: 

D Changes to the root directory (/). 

n Warns users of impending shutdown and waits a specified delay 
time (default wait is 60 seconds). 

n Stops non-essential system and user processes. 

n Changes the run-level to single-user (30 second delay). 

D Unmounts file systems other than root. 

a Executes sync to flush the system cache buffers to disk. 

n If -r or -h was used, reboots or halts the system. 

shutdown Syntax 

7^ /etc/shutdown [ -r \ -h ] [grace] 

Key Operation 

-r Automatic reboot following shutdown. 

-h Halts the system following shutdown. 

grace Optional number of seconds to wait before killing 

processes. 

reboot Syntax 

# /etc/reboot [ -h \ -r ] [ -n ] [ -s ] 

Key Operation 

-h Halts the system. 

-r Reboots the system automatically (default). 

-n No sync before halt or reboot. 

-s sync before halt or reboot (default). 
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Backup/Restore 



Recovering from a Catastrophic Data Loss 

To recover, perform the following: 

1. Install HP-UX. 

2. Perform applicable updates. 

3. Create file systems on non-system disk drives. 

4. Restore applicable incremental backup(s). 

5. Restore last complete backup. 



tar Tape File Archiver 

■ Saves and restores files on magnetic tape of flexible disk. 

■ When a directory is to be saved, tar recursively searches down the 
tree to save all related subdirectories and files. 

■ Files saved with full path names will be restored to the same 
locations. Directories are created as required. 

■ Files saved with relative path names (./path) can be restored on any 
directory. 



Caution 



• 



Default option is N (see following pages for full 
explanation). 

Due to internal limitations in the header structure, 
not all file names of fewer than 256 characters fit 
when using the N key. If a file name does not fit, 
tar prints an error message and does not archive 
the file. 

Symbolic link names are limited to 100 characters 
when using the N key. 

Tape errors are handled ungracefully. 
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tar Tape File Archiver Command Syntax 

The tar command and common options are shown below: 

# tar key [arg ... 7 [file \ -C directory] 

Where: 

Key Operation 

c Creates an archive (save). 

X Extracts from an existing archive (restore). 

V Verbosely shows tar operations and displays each file 

accessed. 
f fsname Use device specified in fsname for save or restore 

(default special device file: /dev/rmt/Om). 
H Cause all entries in hidden directories 

(context-dependent files) to be written in archive, 
m Restore files from archive with current system date and 

time stamp. 
N Default. Write a new (POSIX) format archive. New 

format allows file names up to 256 characters; archives 

and restores special files and symbolic links. 
O Write in old (pre-POSIX) format. 

u Update existing file in archive (very slow). 

t List all filenames in archive (with v option adds file 

mode and owner), 
r Append file(s) to end of existing archive. 

-C directory tar will change to directory and continue save or 

restore. 
w Wait for user confirmation of tar operations. 

h Treats symbolic links as normal files or directories. 

tar Examples 

■ Create an archive of all files associated with your home directory 
(and subdirectories) to the default tape drive verbosely: 

$ cd 

% tar cv * 

■ Create an archive of /full/path/file 1 and /full/ path/ name /file 2 to a 
high-density tape drive verbosely: 

# tar cvf /dev/rmt/Oh /full/path/file 1 /full/path/name /file 2 
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■ Create an archive of all files on /directory using relative pathnames 
so it can be restored on any directory: 

# tar cv ./directory 

■ Create an archive of all files on two unrelated directories to a 
high-density tape drive: 

^ tar cvf /dev/rrnt/Oh /full/ path /dirtctoryl /full /path /directory 2 

m List all archived files on the default tape drive to the printer: 

# tar tv I Ip 

m Restore the entire archive from the default tape drive verbosely: 

# tar XV 

■ Restore a single file from a high density tape drive: 

$ tar xvf /dev/rmt/Oh /full/ path /name /file 1 

■ Restore all files saved by relative pathing to /my /directory: 

#: cd /my/ directory 

# tar XV 

■ Restore a file saved by relative pathing to /my /directory: 

# cd /my/directory 

■#■ tar XV ./subpath/filel 

NotG ^<^^ will not accept HP-UX wild card characters in 

pathnames when restoring files on a system. 



. 
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cpio Copy File Archives In and Out 

cpio copies files in or out of an archive. An archive may be a file or a 
raw physical device. 

cpio -o Reads STDIN to obtain a list of path names and 

copies those files to STDOUT along with path 
names and status information. Normally, 
redirection is used to make an archive file or 
tape. For example: 

# Is I cpio -0 > /dev/rmt/Om 

cpio -i [pattern] Extracts from STDIN (an archive file) those 

filenames that match zero or more patterns. The 
files are recreated based on the paths placed in 
the archive by cpio -o. 

For example: 

# cpio -i chapter[l-5]* < /dev/rmt/Om 

cpio -p directory Reads STDIN to obtain a list of path names and 
copies those files to a previously created target 
directory. For example: 

# Is I cpio -p archivedir 
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cpio Command Syntax 

The cpio command and common options are shown below: 

# cpio -0 [BcxvhJ 

a^ cpto -I [Bdciuxv] [patterns] 

^ cpio -p [duxvj directory 



Where: 

Key 

c 
d 
t 

X 



patterns 

h 
B 

u 
directory 



Operation 

Write header information in ASCII for portabihty. 

Create directories as needed. 

Print only table of contents from the input. 

Save or restore special device files, mknod recreates 

these files on restore (superuser only). Restoring 

special device files onto a different system can be 

dangerous; use only on HP-UX machines. Backups 

made for one system should not be restored on another. 

Verbose; causes list of file names to be printed. 

Only files that match patterns according to the rules of 

Pattern Matching Notation are selected. The default 

for patterns is *. 

Follow symbolic links as if they were normal files or 

directories. Normally cpio archives the link. 

I/O is blocked to 5120 bytes per record (meaningful 

only when data is directed to devices which support 

variable length data such as magnetic tape). 

Copy unconditionally (older file will replace newer file). 

Destination directory tree. 
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cpio Examples 

■ Save all files in current directory in blocks with ASCII headers onto 
medium speed magnetic tape: 

# Is I cpio -ocBx > /dev/rmt/Om 

■ Use find command to save all files on your working directory 
recursively with ASCII headers onto high-speed magnetic tape: 

# find . -print \ cpio -ocBx > /dev/rmt/Oh 

■ Use find command to save all files on your working directory 
recursively with ASCII headers onto an archive directory: 

# find . -print \ cpio -pdxv /archive ^directory 

■ Print a listing of an archive to the printer: 

# cpio -icBtxv < /dev/rmt/Om \ Ip 

■ Restore /path/myfile from tape: 

i^ cpio -icBxv /path/myfile < /dev/rmt/Om 
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tcio Tape Cartridge Formatter 

icio reads or writes data to a character Command Set 80 Cartridge 
Tape Unit special device file specified in filename. 

tcio -0 Reads STDIN and writes data to the Command Set 

80 Tape Unit. 
tcio -I Reads Command Set 80 Tape Unit and writes data 

to STDOUT. 



tcio Tape Cartridge Formatter Command Syntax 

The tcio command and common options are shown below: 

# tcio -ofdrvV] [-S buffersize] devicefile 

# tcio -t[dvr] [-S buffersize] devicefile 

# tcto -ufrV] devicefile 

Where: 

Key Operation 

d Prints checksum to STDERR (normally terminal). 

User may record this number for comparison of 

checksum value on restore. Checksum is not recorded 

on tape, 
r Release the tape from the mechanism, unlocking the 

door. 

V Verbose mode; prints information and errors to 
STDERR. 

S buffersize Forces memory of buffersize to be reserved for 

reading or writing the tape. Size of the buff"er is 1014 
times buffersize (range: 32-512). If buffersize is not 
specified, tcio defaults to the maximum size available. 

devicefile Special device file of tape unit. 

V Power OFF tape verification. 

u Perform utility function. Used with r to unlock tape 

cartridge door. 
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tcio Examples 

■ Save all files in current directory in blocks with ASCII headers onto 
an integrated disk and cartridge tape on single controller: 

7^ Is I cpio -ocBx I icio -o /dev/rci/cldls2 

■ Use find command to save all files on your working directory with 
ASCII headers onto cartridge tape: 

# find . -print \ cpio -ocBx \ tcio -o /dev/rct/cld0s2 

■ Print a listing of an archive to the printer: 

# tcio -IV /dev/rct/cldls2 \ cpio -ict \ Ip 

■ Restore /path/myfile from cartridge tape: 

# tcio -IV /dev/rct/cldOs2 \ cpio -icBxv /path/myfile 

■ To unlock tape cartridge door: 

# tcio -urV /d€v/rct/cld0s2 
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/etc/fbackup Backups 

• The HP Recommended System Backup Utility 

o Syntax: 9^ fbackup -f devtcefile [-0-9] [options] 

Common Options 

Key Operation 

-/ devtcefile Devicefile identifies the backup device. 

[-0-9] Backup level (0 = full backup; 1-9 indicates an 

incremental backup). 
-i / e Include/exclude file tree from backup (cannot be used 

with -u). 
-I f^name Create index of backup files in f_name. 

-g f_name Use f^name as graph file (must be used with -u 

option). 
-u Update /usr/adm/fbackupfiles/dates (cannot be used 

with -t I -e). 
-V Verbose. 

-H Search hidden subdirectories (context-dependent 

files). 

NotG ■ The user oi fbackup need not be superuser. If the 

I user does not have access to a given file, the file is 

MB NOT backed up. 

■ fbackup does not backup network special files. 

■ fbackup may not work correctly with NFS mounted 
file systems. 
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/etc/fbackup Backup Examples 

■ To backup all mounted files (assumes superuser capability): 

# /backup -f /dev/rmt/Oh -OvHi / 

■ To backup all files residing on /extra tree except /extra/users: 

9^ /backup -/ /dev/rmt/Oh -OvHi /extra -e /extra/users 
m To backup /users file tree to cartridge tape: 

# /backup -OvHi /users -/- | tcio -ov /dev/rct/cld0s2 



1-70 HP-UX Basics 



/etc/frecover Restores 

• Works in Conjunction with /backup Archives 
o Syntax: 

7^ frecover -R path [-f devicefile] 

# frecover -r [ovX] f-f devicefile] 

# frecover -x [ovX] f-g f^name] [-i path] f-e path] f-f devicefile] 

# frecover -I path f-f devicefile] [-c config] 

^ frecover - V path [-vy] f-f devicefile] [-c config] 

Common Options 

Key Operation 

-r Recover all files on backup tape. 

-/ devicefile Devicefile identifies the backup device (default is 

/dev/rmt/Oh). 
-X Files identified by -z, -e, or -g are extracted/not 

extracted. 
-g f^name Use f_name as graph file. 

-i / € Include/exclude file tree from backup. 

-/ path Create index of backup tape and place it in the path. 

-0 Recover file regardless of age. 

-v Verbose. 

-X Recover files relative to the current working directory. 

- V path The volume header from the backup is written to the 

path . 
-R path Restart interrupted frecover. 

-c config Use configuration file for error actions. 

Note ■ The user of frecover need not be superuser. If the 

I user does not have access to a given file, the file is 

Mtt not restored. 

■ frecover does not work with network special files. 
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Recovering Files with /recover 

■ To recover all files from an fbackup archive tape (assumes superuser 
capability): 

if: /recover [-r] -o -f /dev/rmt/Oh 

The -r option is the default value. The -o option causes /recover to 
restore a file in the archive that is older than one existing within the 
file system. 

■ To restore all files archived on /extra tree except /extra/users: 

# /recover -x -i /extra -e /extra/users -/ /dev/rmt/Oh 

■ To restore the /users file tree from cartridge tape: 

# tcio -IV /dev/rct/cld0s2 \ /recover -x -vi /users -/- 
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dd Device-to-Device Copy 

■ dd is an all purpose utility that copies the specified input file to 
the specified output file. Using dd options, data conversions are 
possible. 

■ Often used to save or restore information disk-to-disk on hard disk 
partitions. 



Caution 



« 



D In the past you may have used the dd command 
to recreate a boot area that has been corrupted 
(by copying the file /usr/lib /uxbootlf to the 
beginning of the raw device file of a disk). DO 
NOT DO THIS ANY LONGER! The LIF area 
at the beginning of an LVM volume is located 
in a slightly different area than for a traditional 
disk. You can destroy all of the LVM information 
on a disk if you do this. Use the /etc/mkhoot 
command to create a boot area on an LVM disk. 
For details on making an LVM disk a bootable 
disk, see Managing Logical Volumes in the 
System Administration Manual, HP part number 
B3108-90005. 

n Never use dd to copy a section of a non-LVM disk 
directly to an LVM physical volume without going 
through the LVM mechanism. That is, if a disk 
represented by the device file /dev/[r]dsk/cldOs2 
is an LVM disk (a physical volume), DO NOT 
use /dev/[r]dsk/cld0s2 as the output file (or 
input file) in the dd command. If you do, you 
will overwrite the LVM data structures at the 
beginning of your LVM disk or overwrite a 
non-LVM disk with LVM disk structures. If you 
no longer want to use the destination physical 
volume as an LVM disk, you must properly remove 
it from the volume group using the appropriate 
LVM commands. 

DO NOT. 

dd if=non-LVM-disk-section-device-file 
of=LVM-physical-volume-device-file 
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You can, however, use a logical volume as a 
destination. 

YOU CAN: 

dd if=non-LVM-disk-sectton-device-file 
of=logtcal-volume-name-device file 

a Just as when working with traditional disk 
sections, the destination must be as big as the 
source, and you must take care not to overwrite 
something critical! 



■ The following is an example of the dd command and syntax to copy 
a file system from one drive to another: 

# dd if=/dev/rdsk/cld0s2 of=/dev/rdsk/c2d0s2 bs=1024k 

m The following is an example of the dd command and syntax to copy 
a non-LVM disk section to a logical volume. Note that the size of 
the destination must be as large as the source. 

# dd if=/dev/rdsk/c5d0s5 of=/dev/vg01/rlvol2 bs=1024k 
Where: 

Key Operation 

tf= Specifies the input file name (default STDIN). 

of= Specifies the output file name (default STDOUT). 

bs= Specifies the I/O block size. 
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UXGEN 



Adding Kernel Drivers 



i/0 
DEVICF 


,1 N 




HP-UX 
KERNEL 




A N 


REST OF HP-UX 

(device- 
independent) 


/ \ 
'\ / 


(device drivers) 


'x^ device file 








' 


\- 


— uxgen 








SSMi FILE 







A new kernel (hp-ux) must be generated using uxgen only when 
adding a device whose associated driver was not previously included 
in the existing Kernel with uxgen (Im). 
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4 ~) uxqen 
created 



The following steps assume that the gen file is named S800: 



'. # ai /pt'./c.onfA^en 

■l. # /Ptc/ii:/qen S8^)(Z) 

'>. # cf) /hf>-ii- /r,YS[u:KUP 

(.. # cfi /etc/cont/oSW) 

UMXA03t3 



7. # mv hp ux /hp-iix 

8. # shutdown -h 

9. Turn the ;:.ystem off. Install hardware. 

10. Turn the power on. Reboo* the system. 

11. # cp /hf)-ux /SYSBCKUP 

12. If boot string changed, modify LIF's 'AUTO' file 



S800— UXGEN Input File 

The S800 file consists of the following sections: 

■ Include statements. 

D # include /etc/master. 

■ Contains connectivity rules for I/O configuration. 

■ Defines major numbers for all devices. 

■ Contains a list of kernel tunable parameters and defaults. 

n Used to add device drivers and optional subsystems to the Kernel 
(hp-ux). 

■ Kernel devices. 

D Specifies the location of console, root, primary swap, and dump(s) 
devices. 

■ Tunable parameters. 

n Used to specify non-default kernel parameters. 

■ I/O statement. 

n Used to configure devices whose drivers do not support 

autoconfiguration (for example: instrO , gpioO/gpiol , psiO, pdnO, 
HiO/riil). 

S800— What Drivers are Kernel Resident? 

■ To list kernel resident drivers, type the following: 

# Isdev 
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S800— Adding Drivers and Subsystems 

■ Determine the correct driver(s) to use for the peripheral or 
subsystem by consulting the list of drivers later in this section; 
Installing Peripherals; or product installation manuals for the 
desired subsystem (LVM, X.25, etc.). 

■ Edit the /eic/conf/gen/S800 file adding the appropriate driver(s) or 
subsystem include statement(s) to the end of the existing include 
statements in the S800 file. 

■ Example: 

To add an HP 2563B line printer driver to the kernel, add the 
following line at the end of the include statements in the S800 
file: 

include lpr6; 

Once this has been accomplished, generate a new kernel using the 
UXGEN Process. 
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S800— Kernel Devices 

■ The HP-UX kernel must know the location of the root file system, 
primary swap device, dumps device (if present), and the console. 

■ Failure to specify the correct location of these necessary devices may 
result in a hung boot, or worse, damage to a file system should the 
kernel be told to swap over the top of a data disk. 

■ The following are examples of typical kernel devices specifications: 

n HP-PB Model 815: 

console on piu::::lj 

root on hpibl. disci at 16.0 section 13; 
swap on hpibl. disci at 16.8 section 15, 
d u r-i p s o n d e f a u 1 1 ; 

n HP-PB Model 827: 

console on r"'iu::-::2 at 56; 

root on I'v'ol ; 

swap on 1'...'q1; 

d u Pi p s o n d e f a u 1 1 ; 

D HP-PB Model 890: 

c o n sole o n b u s _ c o n '■.' e r t e r . la n r-i u :>:: . n u ::■:; 4 at 0.44. 8 
root on luol; 
swap on Ivol; 
dumps on default; 
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Kernel Device— Console 

■ Syntax: 

console on <driver_path> at <hdw^address>; 

or 
console on default; 

■ Examples: 

n Default console path 

conso 1 e on def au 1 1 ; 

n CIO system console on machines without System Main Bus 
(SMB) 825/835/625/845/645: 

c o n sole o n c i o _ c a . n u ::■:; £i a t 8 . U j 

n CIO system console on machines with System Main Bus (SMB) 
850/855/860/865/870: 

conso 1 e on bus.conuert er . c i o_ca9 . nui-iQ at 2.4. 1 ; 
n HP-PB system console on 808/815/822/832/842/852: 
c o n sole o n r-i u :>:: 1 at 16; 

□ HP-PB system console on 8x7: 

console on p'iu::::2 at 56; 
D HP-PB non-LAN system console 890: 

c o n sole o n b u s _ c o n '■.' e r t e r . r-i u ::•:; 4 a t 8.44; 

□ HP-PB LAN system console 890: 

c o n sole o n b u s _ c o n u e r t e r . la n n u ::■:; 9 . n u x 4 at 6.44. Hi ; 
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Kernel Device— Root 

■ Syntax: 

n Non-LVM Root Device 

root on default [section <integer>]; 

or 
root on <driver_path> at <hdw-address> [section <integer>J: 
a LVM Root Device 
root on Ivol; 

or 
root on default [section <integer>]; 

■ Non-LVM Root Device Examples: 

D Use default section as root device: 

root on default; 
□ HP-PB root device on 808/815/822/832/842/852: 

root on hpibl. disci at 16.0 section 13 j 

D CIO root device on machines without System Main Bus (SMB) 
825/835/625/845/645: 

root on c i o_ca0 . hp i b 1 . d i sc 1 at S . 9 . sect i on 1 3 ; 

a CIO root device on machines with System Main Bus (SMB) 
850/855/860/865/870: 

root on bus_conuert er . c i o_ca0 . hp i b 1 . d i sc 1 at 
2.4.0.0 section 13; 

■ LVM Root Device Example: 

n Use root section as defined in the Boot Data Reserve Area 
(BDRA) and LIF's LABEL file: 

root on I'-'ol; 
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Kernel Device—Swap 

■ Syntax: 

D Non-LVM Swap Device 

swap on default [section <integer>]; 

or 
swap on <drtver_path> at <hdw_address> [section <integer>J 

<driver_path> at <hdw_address> [section <integer>]: 
a LVM Swap Device 
swap on Ivol; 

or 
swap on default [section <integer>]; 

■ Non-LVM Swap Device Examples: 

D Use Boot Disk section 15 as primary swap device: 

swap on default; 
D HP-PB primary swap on 808/815/822/832/842/852: 

swap on hpibl . disci at 16. section 15? 

n CIO swap devices on machines with System Main Bus (SMB) 
850/855/860/865/870: 

swap on bus_coni-.-'ert er . c i o_ca0 . hp i bS . d i sc 1 at 
2.4.0. sect i on 1 5 

bus_coni-.-'ert er . c i o_ca0 . hp i bu . d i sc 1 at 
6.S.0.5 section 11; 

■ LVM Swap Device Example: 

D Use default as primary swap device as defined in Boot Data 
Reserve Area (BDRA) and LIFs LABEL file: 

•=:i,i.5p on 1 i.,"o 1 ; 
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Kernel Device— Dumps 

■ Syntax: 

n Non-LVM Dumps Device(s) 

dumps on default [section <integer>]; 

or 

dumps on <driver^path> at <hdw_address> [section 
<in.teger>] 

<driver^path> at <hdw_address> [section <integer>]; 

a LVM Dumps Device(s) 

dumps on default [section <integer>]; 

or 

dumps on Ivol; 

m Non-LVM Dumps Device Examples: 

D Use default section (primary swap) as dumps device: 

d u fi p s o n d e f a u 1 1 j 

D HP-PB dumps device on 808/815/822/832/842/852: 

dumps on hpibl. disci at 16.2 section 15 j 

a CIO dumps device on machines without System Main Bus (SMB) 
825/835/625/845/645: 

dup-ips on c i o_ca0 . hp i b£i . d i sc 1 at 8 .0.2 sect i on 9 ; 

D CIO multiple dumps devices on machines with SMB Main Bus 
(SMB) 850/855/860/865/870: 

dumps on bus_con'...'ert er . c i o_ca0 . hp i b0 . d i sc 1 at 
2.S.0. 1 sect ion 15 

bus_con'v'ert er . c i o_ca0 . hp i bo . d i sc 1 at 
6 . 3 .0.5 sect i on 1 5 ; 
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LVM Dumps Device Examples: 

D Use default (primary swap) as dumps device; 

d u Pi p s o n d e i' a u 1 1 ; 

n Use one or more LVM dumps devices (information resides in the 
Boot Data Reserve Area (BDRA) and LIFs LABEL file): 

dur-ips on l'..'ol; 
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I/O statement Syntax 

■ The I/O statement in the S800 file must begin with io { and end 
with }. See examples below. 

■ Curly braces pairs must enclose driver I/O statements unless the 
driver is the only or final driver in a driver path. See examples 
below. 

■ Semicolons must be used to end I/O statements at the end of a 
driver chain. See examples below. 

■ Comments begin with /* and end with */. See examples below. 



Non-Automatically Configurable Devices 

Device controlled by drivers that do not automatically configure 
(for example: instrO , gpioO/gpiol , psiO , pdnO , riiO/riil) MUST be 
specified in the I/O statement. 

Some examples: 

■ To add an HP-IB instrument or HP-IB plotter on a CIO system at 
physical path 4.2.7: 

i o C 

cio_ca0 ■address 4 C 

hpib0 address £ C 

instr0 address 7j 

> ■■■•■* ends hpibS driMer st-atenent *.-' 
'} ■••■' * ends c i o _ c a y d r i u e r s t a t e r-'i e n t * ••■■ 

.'■ ••■' * ends io st-atenent *•■■■ 

■ To add a General Purpose I/O card on a HP-PB system at physical 
path 48 (slot 12): 

i o -C 

9Piol -address 48? 
> ■••■■* ends io st-atenent *■••■ 
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CIO (Mid-bus) Architecture Drivers 

• System Main Bus Driver 



Name 


Supported Devices 


bus_ converter 


Bus Converter Interface (required on 
850/855/860/865/870 only) 



Mid-Bus Driver 



Name 


Supported Devices 


cio_caO 


CIO Channel Adapter Interface 



CIO Cardcage Bus Master Device Drivers 



Name 


Supported Devices 


hpibO 


HP-IB Interface (27110 card). Supports up 
to 8 HP-IB peripherals 


hpflO 


HP-IB Interface (27111 card). Supports up 
to 8 HP-FL peripherals 


scsi2 


CIO SCSI (27147 card). Supports up to 7 
SCSI 
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CIO Cardcage Device Adapter Drivers 



Name 


Supported Devices 


disci 


CS/80 and SS/80 devices (disks and 
cartridge tapes) connected via HP-IB 
interface (27110 card) 


disc2 


CS/80 devices (disks) connected via HP-FL 
interface (27111 card) 


disc3 


Disk devices connected via SCSI interface 


tapel 


1/2 inch Magnetic tape drives and HP 
C1511 HP-IB DDS- Format Tape Drive 


tape2 


SCSI tape drives such as the HP C1512A 
SCSI DDS-Format Tape Drive 


IprO 


256X line printers (using CIPER protocol) 


Iprl 


2932/2934 and 2235 line printers (using 
Amigo protocol) 


lpr3 


C2753A Model FlOO SCSI printer protocol 


muxO 


RS-232 (serial) peripherals (27140 card); 
includes terminals, printers, and plotters (8 
ports available) 


mux0_16 


Same as above with 16 ports 


instrO 


All other HP-IB peripherals (plotters, other 
printers, general HP-IB instruments) 


lanO 


Networking (27125 card) 


gpioO 


General-purpose parallel I/O interface 
(27114 card) 
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CIO Cardcage Device Adapter Drivers, Cont. 



Name 


Supported Devices 


osiO 


OSI Express Card interface (32124A or 
32125A cards) connected via HP Air26 bus 
converter supporting HP MAP 3.0 
networking 


autoch 


Optical Library Systems 


autoxO 


650 Mbyte magneto (rewritable) optical disk 



HP-PB Architecture Drivers 

• HP-PB Bus-Master Drivers 



Name 


Supported Devices 


cio_caO 


HP-FL disks that are connected to the HP 
A1749A HP-PB Fiber-Optic Link (PBA-FL) 
Precision Bus Device Adapter 


hpibl 


HP-IB interface (28650 card). Supports up 
to 8 HP-IB peripherals 


hpflO 


HP-FL Disks that are connected to the HP 
A1749A HP-PB Fiber-Optic Link (PBA-FL) 
Precision Bus Device Adapter 


hpfll 


HP-FL disks that are connected to an HP 
286 L5 A card 


scsil 


SCSI port on the 28655A HP-PB 
SCSI/Parallel Adapter card 
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HP-PB Device Adapter Drivers 



Name 


Supported Devices 


disci 


CS/80 and SS/80 devices (disks and 
cartridge tapes) connected via HP-IB 
interface (28650 card) 


disk2 


HP-FL disks connected to HP A1749A 
HP-PB Fiber-Optic Link (PBA-FL) 
Precision Bus Device Adapter 


disc3 


Disks such as HP 7957S connected via SCSI 
interface 


disk4 


HP-FL disks that are connected to the HP 
28615A Fiber Optic Link Adapter 


sccl 


RS-232C for Serial Communications 
Controller (SCC) on motherboard or CPLI 
of HP 9000 Models 808/815 only 


tapel 


1/2 inch Magnetic tape drives and HP 
C1511 HP-IB DDS- Format Tape Drive 


tape2 


SCSI tape drives such as the HP C1512A 
SCSI DDS-Format Tape Drive 


autoch 


Optical Library Systems 


autoxO 


650 Mbyte magneto (rewritable) optical disk 


IprO 


256X line printers (using CIPER protocol) 


mux2 


RS-232C (serial) peripherals (40299 card); 
includes terminals, printers, and plotters 


mux4 


RS-232C (serial) peripherals connected to 
the built in ports on HP 9000 Model 890 
computer 


instrO 


All other HP-IB peripherals (plotters, other 
printers, general HP-IB instruments) 
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HP-PB Device Adapter Drivers 



Name 


Supported Devices 


lanl 


Networking designed for HP 28562-60001 
LANLINK card 


gpiol 


General-purpose parallel I/O interface 
(28651 card) 


osiO 


OSI Express Card interface (32122 or 32123 
cards) supporting HP MAP 3.0 networking 



Isdev 

m Lists I/O drivers contained in the kernel (lip-ux). For each I/O 
driver, the character and block major numbers, and the device class 
are displayed. 



ample output: 








Character 


Block 


Driver 


Class 


-1 


-1 


processor 


processor 


-1 


-1 


memory 


memory 


50 


-1 


lanO 


Ian 


5 


5 


tapel 


tape_drive 


1 


-1 


muxO 


tty 


7 


8 


disci 


disk 


-1 


-1 


cio_caO 


cio 


-1 


-1 


hpibO 


hpib 


60 


-1 


nm 


pseudo 


56 


-1 


ni 


pseudo 
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ioscan Syntax 

■ Probes and displays the I/O configuration of a running system. 

■ Syntax: 

ioscan [-k\-u] [-d dvr \ -C class] [-1 lu] [-H hdw-path] f-f [-n]J [devfilej 

or — 

ioscan [-M . . . ] [-H hdw^path] 

■ Options: 



Key 

-k 

-u 

-d 

-C 

-I 

-H 

-f 
-n 
-M 

hwd^path 

none 



Operation 

Displays kernel data structures; does not scan 

devices. 

Displays usable devices; does not scan devices. 

Selects devices associated with an I/O driver. 

Selects devices in a device class. 

Selects devices with a given logical unit number. 

Selects devices at a given hardware path. 

Full listing; includes software paths, status, etc. 

Lists device files associated with each device. 

Driver, or string of drivers separated by periods, 

that specify hardware device(s). 

Physical address of device (for example 

BC/X.Y.Z.U). 

Probes the devices and displays information for all 

the devices in the system. 
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ioscan Default Behavior 

# ioscan 



Hardware 


Description 


Status 


Path 









processor 


ok 


4 


cio 


ok 


4.0 


hpfl 


ok 


4.0.0 


disk 


ok 


4.1 


tty 


ok 


4.2 


hpib 


ok 


4.2.0 


disk 


ok 


4.2.4 


tape_ drive 


ok 


4.4 


Ian 


ok 


4.6 


hpib 


ok 


8 


memory 


ok 


12 


memory 


ok 



ioscan Listing Device Files 

9^ ioscan -fn -C tape -drive 

Class LU H/W Driver 

Path 



H/W Status S/W Status 



tape_drive 1 4.2.4 



cio_ca0.hpib0.tapel 

/dev/diag/mt/1 

/dev/mt/lh 

/dev/mt/lhn 

/dev/mt/11 

/dev/mt/lln 



ok(0xl78) 

/dev/mt/lm 

/dev/mt/lmn 

/dev/rmt/lh 

/dev/rmt/lhc 

/dev/rmt/lhn 



ok 

/dev/rmt/ll 

/dev/rmt/lln 

/dev/nnt/llin 

/dev/rmt/lnm 



# ioscan -fn -H 4-1 

Class LU H/W Driver 

Path 



H/W Status S/W Status 



ttv 



4.1 



cio_ca0.nxuxO 
/dev/diag/muxO 
/dev/muxO 
/dev/ttyOpO 



ok(0x7) 
/dev/ttyOpl 
/dev/ttyOp2 
/dev/tty0p3 



ok 

/dev/ttyOp4 

/dev/ttyOpS 
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ioscan Full 


Listing 






# ioscan 


-/ 










Class 


LUH/W 


Driver 


H/W Status 


S/W Status 






Path 








processor 


- 





processor 


ok(OxO) 


ok 


cio 


- 


4 


cio_caO 


ok(OxlOOO) 


ok 


hpfl 


- 


4.0 


cio_ca0.hpflO 


ok(0x8) 


ok 


disk 





4.0.0 


cio_ca0.hpfl0.disc2 


ok(0x2) 


ok 


tty 





4.1 


cio_ca0.muxO 


ok(0x7) 


ok 


hpib 


- 


4.2 


cio_ca0.hpibO 


ok(0x2) 


ok 


disk 





4.2.0 


cio_ca0.hpib0.discl 


ok(0x22b) 


ok 


tape_drive 


1 


4.2.4 


cio_ca0.hpib0.tapel 


ok(0xl78) 


ok 


Ian 





4.4 


cio.caO.lanO 


ok(0x6) 


ok 


memory 


- 


8 


memory 


ok(0x800) 


ok 


# ioscan ■ 


■fu 










Class 


LUH/W 


Driver 


H/W Status 


S/W Statu.s 






Path 








disk 





4.0.0 


cio_ca0.hpfl0.disc2 


ok(0x2) 


ok 


tty 





4.1 


cio_ca0.muxO 


ok(0x7) 


ok 


tape_drive 





4.2.3 


cio_ca0.hpib0.tapel 


ok(0xl78) 


ok 


tape_drive 


1 


4.2.4 


cio_ca0.hpib0.tapel 


ok(0xl78) 


ok 


Ian 





4.4 


cio_ca0.1auiO 


ok(0x6) 


ok 
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Device Files 



I/O 
DEVICE 



HP-UX 
KERNEL 

(hardware addresses 

and device drivers) 



/^ aevice fiie ^ 



REST OF HP-UX 

ide-j'ze- 
independer-if 



Figure 1-14. Device Files 

Special device files link the kernel to the rest of HP-UX. 

Special device files pass device dependent parameters (for example: 
driver name, tape density, modern configuration, etc.) to the kernel. 

Transfer data by character (raw), or in blocks (cooked). 

Must reside in the /dev directory. 

Created by tnsf , mksf, or mknod commands after system 
generation. 
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Block and Character Devices 
Block Devices 

■ I/O operations are done in blocks buffered by the kernel's file 
system cache. 

■ Disks with MOUNTED file systems use block I/O. Standard block 
size transfer size is 8192 bytes. Block sizes of 8Kb and 4Kb are 
supported. 

Character Devices 

■ I/O operations on character devices are done in character data 
streams using minimal buffering by the kernel. 

■ All devices support character I/O. 

■ UNMOUNTED disk file systems, use character data streams for 
I/O. 
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/dev Directory: Peripheral Device Files 




Figure 1-15. /dev Directory: Peripheral Device Files 
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Device File Naming Conventions 
Terminal Device Files 

/dev/UyOpO Where: 

Key Operation 

tiyO is a logical unit number (lu) assigned by insf . 

pO is the multiplexer port number (0-5). 

MODEM Device Files 

Dial-in MODEM Device File Names. 

/dev/nyd2p3 Where: 

Key Operation 

d Designates a dial-in modem. 

2 A logical unit number (lu) assigned by insf . 

3 The multiplexer port number (0-5). 

UUCP MODEM for Automatic Dial-Out. 

/dev/cua2p3 Where: 

Key Operation 

2 A logical unit number (lu) assigned by insf . 

3 The multiplexer port number (0-5). 

UUCP MODEM for Manual Dial-Out. 

/dev/cul2p3 Where: 

Key Operation 

2 A logical unit number (lu) assigned by insf . 

3 The multiplexer port number (0-5). 
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Magnetic Tape Device Files 

/dev/[r]mi/udn Where: 

Key Operation 

[r] When present, indicates that file can be found on 

the character (raw) directory for this device. 

u The logical unit (lu) assigned by msf . 

d Identifies tape density: h (high density, 6250 bpi), 

m (medium density, 1600 bpi), or / (low density, 
800 bpi). 

11 When present, indicates no rewind after write. 

Examples: 

/dev/rmt/Oh Logical unit 0, high density, character device file. 

/dev/rmi/lhn Logical unit 1, high density, character device file, no 
rewind after write. 

Disk Device Files 

Conventional High-Performance File System (HFS) Device Files. 

/dev/[r]dsk/cXdOsZ Where: 

Key Operation 

r When present, indicates that file can be found on 

the character (raw) directory for this device. 
A' Logical unit number (lu) A' assigned by msf . 

Z Section number Z addressed by this device file. 

Examples: 

/dtv/rdsk/cOdOs^ Logical unit 0, section 4. character device file. 

/dev/dsk/cld0s2 Logical unit 0, section 4. block device file. 
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Logical Volume Manager (LVM) File System Device Flies. 

/dev/vgXX/[r]lvolNN Where: 

Key Operation 

XX Integer volume group number to which the logical 

volume belongs. 

r When present, specifies use of the character device 

file associated with the logical volume specified. If 
absent, the block device file will be used. 

NN Integer logical volume number. 

Examples: 

/dev/vgOO/lvoll Volume group 00, logical volume 1, block 

device file. 

/dev/vg01/rlvol3 Volume group 01, logical volume 3, character 

device file. 
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Printer Device Files 

/dev/lpX Where: 

Key Operation 

A' Logical unit number (lu) A' assigned by tnsf . 

Cartridge Tape Device File Names 

/dev/[r]ci/cXdYsZ Where: 

Key Operation 

r When present, indicates that file can be found on 

the character (raw) directory for this device. 
A^ Logical unit number (lu) A' assigned by tnsf . 

Y Unit number Y {0 = does not share same controller 

as disk; 1 = shares same controller as disk drive, for 

example: 7914CT). 
Z Section number Z addressed by this device file 

(typically 2; section 2 accesses all sections of tape). 
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Device Files Needed by HP-UX 



Filename 

syscon 
systty 
console 


Use 

Access system console 
Access system console 
Access system console 


Recreated by: 

} 

} msf -d en 

} 


diagO/ 
dmem 
ktest 


HP-UX diagnostics 
HP-UX diagnostics 
HP-UX diagnostics 


insf -d diagO 
insf -d dmem 
insf -d ktest 


kmem 

mem 

null 


Virtual memory 
Physical memory 
Bit bucket 


} 

} insf -d mm 

} 


config 


Access I/O configuration 


insf -d devconfig 


root 
rroot 


Access root device during 
system start-up 


insf -d root 



tty 



Access user terminal 



insf -d sy 



Note 

4 



Remember to change directories to /dev before 
executing the tnsf command. 
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/etc/lssf 

■ Lists characteristics of special files: 

- Driver name 

- lu number 

- Driver options 

- HP-UX software address 

- Device file path 



Note ^^^f will NOT list Logical Volume Manager (LVM) 

device files. Use // instead. 



4 



Examples: 

# Issf /dev/dsk/c7d0s3 disk2 lu 7 unit section 3 address 4.0.0 

/dev/dsk/c7d0s3. 

# Issf /dev/ttylp5 muxO lu 1 port 5 hardwired address 4.5 

ttylp5. 
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(Q 

C 



z 
o 

D 
m 

M 

a) 
3 
-o 
<» 



# mknod /dev/ttyd2p2 c 1 0x 200202 

L see Config. HP-UX for Peripherals for minor # description. 

see /etc/master for major # identifying 'muxO' driver or 

indicates character (raw) device run isdev 

port 2 

lu 2 (third multiplexer box) 

dial-in 



M = Direct 
tl^ = Call out 
<5 = Simple Ml = Call in 
1 = CCITT 11 = Invalid 



not 
used 



~* 



1 I\ 



mux lu# 



port # 



C 
X 

OD 

a) 

(A 



o 

0> 



Ox 

k 

indicates 
hexadecimal 

UNXA0412 



31 


30 


29 


28 


27 


26 


25 


24 


23 


22 


21 


20 


19 


18 


ir 


16 


16 


14 


13 


12 


11 


10 


9 


8 


i5 1 (& 


(Zi <& 


(Z) (» (D 


(J (2) 1 (J 


(D ® © (J 


18) 
















V V V V V V 

2 2 2 





^ 


s 


o 


e^ So' 


^ 


o 


O (t 


z 


3 

3 
fi) 


•T3 


o 

o 


?D~ 


m 


3 


3 


X 

3 


Q. 
(0 


en 


■o 


O 


P 


(D 




CL 




S 


P 




0) 


il. 




PT 






<D 


3 






o 




D 






(D 


B 




< 

MMB 






o 


o 




<D 


SL 




"n 

■ma 


a- 

0) 




(D 


< 




0) 



ftl 



to 



mksf 

■ Creates one or more special device files for the specified driver. 

■ Extracts the major number from the kernel (hp-ux). 

■ Command syntax varies depending on the driver type (muxO, discO, 
etc.). 

Syntax example for a muxO driver: 

# mksf -d muxO [-1 lu] [-p port] f-h \ -i \ -o] [-c] [path] 

Key Operation 

-d muxO Specifies driver to use for special device file(s) 

created. 
-/ lu Logical unit number (lu) of a device as assigned by 

insf . 
path Default path name is ^^^<lu>/)<port>. 

-c CCITT (European Standard). 

-h Hardwired (direct connect). 

-I Dial-in modem. 

-0 Dial-out modem. 

-p Multiplexer port number (0-5). 

■ This example makes a dial-in modem special device file for mux lu 
2, port 2. 

# cd /dev 

# mksf -d muxO -I 2 -p 2 -i ttyd2p2 
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insf 

CdUtion The insf command should only be run in single user 

• mode. To accomplish this, type the following from 

the system console: 

# cd / ; shutdown 



N0t6 ^^*/ builds device files in the working directory, 

- therefore, cd to the target directory before invoking 

MH the command. The target directory is often /dev. 

■ Reads information about devices directly from the kernel (hp-ux). 

■ Assigns a logical unit number to each new device. 

■ Creates all default special files for each supported device. 

■ Sets appropriate file permissions. 

■ If needed, set appropriate file ownership. 

■ Creates diagnostic special files. 

■ Uses standard path naming conventions. 
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Syntax 

# /etc/msf [-d driver 



■C class] [-H hdw_path] [-1 h] f-f] [-k] [-ej 



No options: Assigns logical unit (lu) numbers and creates default 
device files for all new devices in the kernel (hp-ux). 

Options: 

Key Operation 

-d Select device associated with an I/O driver {discO , 

etc.). 
-C Select devices in a device class (disk, printer, etc.). 

-H Select device at a hardware address (8.0.0, etc.). 

-/ Select device with a particular lu or assign a specific lu. 

-/ Force a specific lu to map to a device. 

-k Assign an lu to the device without creating device files 

(cannot be used with the -e option), 
-e Create device files for devices having lu numbers 

(cannot be used with the -k option). 



Examples: 

:j^ cd /dev : tnsf 

Assigns logical unit (LU) numbers to new devices and creates 

default device files for those devices. 
:^ cd /dev; tnsf -e 

Rebuilds device files for existing (as opposed to new) devices. 
# cd /dev ; tnsf -H BC.X. Y.Z. U -I lu 

Assigns logical unit number lu to the device indicated by 

path BC.X. Y.Z. U . This will fail if the logical unit number is 

currently assigned to another device. Use rmsf -k or rmsf -H 

to remove an LU number. 
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rmsf 

m Removes device files and logical unit (LU) number(s) assigned to 
hardware path(s) in the kernel. 

■ Syntax: 

S. rmsf l-a I -kl de.vfile 

II J L I J J 

# rmsf [-k] [-d driver \-C class] -H hdw^path 
m Options: 

Key Operation 

-a Removes device information in kernel and the device 

file(s). 

-k Removes device information in the kernel only. 

-d Selects devices controlled by an I/O driver. 

-C Selects devices in a device class. 

-H Selects device at a hardware address. 

■ Examples: 

# rm.sftty2p0 

Removes the device file. Device information in kernel is 
retained. 

# rmsf-HBC.X.Y.Z.U 

Removes device information in the kernel and device file(s) 
associated with path BC.X.Y.Z.U 
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Line Printer Spooler System 
User Capabilities 

■ Queue files to printers. 

■ Obtain status of Ip system. 

■ Cancel any print job. 

■ Mark printers in and out of service. 

LP Administrator Functions 

■ Change configuration of system. 

■ Mark printers in and out of service. 

■ Start and stop the system. 
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spooling System Directory Overview 



I / I (root) 



cshcg! 

disable 
enable 




Ipstat 




Ipadmin 
Ipfence 

Ipshut \ '\., accept 
\ Ipmove 
Ipsched 



request | I class I I member I I model I I interface! 



Figure 1-17. Spooling System Directory Overview 
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spooler System Terminology 

Term Meaning 

Class - A grouping of printers. 

- Must have at least one printer. 

- Usually contains more than one printer. 

- Printers may be assigned to more than one class. 



Device 



Printer 



Port on system where printer is connected. 
Accessed through the device file /dev/lp{n), or other 
device file on /dev. 

Logical name of a physical device. 
Name used for actual printer. 



Destination - Place where the files will be queued. 

- Destination can be a queue for a particular printer, 
or class of printers. 

Scheduler - Runs when system is multi-user. 

- Routes requests on a FIFO or priority basis. 

- Enables files to be printed on a specific printer or 
printer class. 



Log 



Log file located in /usr/spool/lp/log . 
Maintains a record of each LP spooler system 
request, including: request ID, user name, printer 
name, time, error messages, and reprints due to 
failure. 
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User Commands 

Common LP Spooler User Commands 

Command Example 



Ip 



$ Ip /etc/passwd 

$ Ip -dprtnter^name filel (select printer by name) 

$ Ip -p4 /etc/passwd (set priority to 4) 



Ipstai 



$ Ipstai -t 



cancel 



$ cancel printer_name-l 17 (cancel job in queue) 
$ cancel pnnter^name (cancel job now printing) 



enable 



$ enable printer_name 



disable 



$ disable -r "Changing Print Ribbon" printer^name 
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/usr/hin/ly 

■ The /p command arranges for the named files and associated 
information (collectively called a request) to be printed by a printer 
or plotter. 

■ The /p command and common options are shown below: 

$ /p [-ddest] [-m] f-nnumber] [-ppnoriiy] [-s] f-ttitle] [-w] [files] 

Key Operation 

-ddest Files will be printed on desi (the name of a 

printer or printer class). If this key is omitted, 
file(s) will be printed on the default system 
printer. 

-m Send mail after the file(s) have been printed. 

nnumber Print number of copies of the specified file(s). 

ppnoriiy Give priority to the print request (specified as a 

integer from through 7 for the lowest through 
the highest priority). The file(s) will be printed 
if equal to or greater than the printer fence 
value; if below the fence, the printout will be 
deferred. 

-s Suppress messages from Ip such as request ID 

is . . . . 

-ttitle Print title on the banner page of the output. 

-w Write a message on the users terminal after 

files have been printed. 

files File(s) to be printed or plotted (default file is 

STDIN). 
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/usr/hin/lpsiat 

■ The Ipstat command prints information about the status of the LP 
spooHng system. It reports the status of the scheduler, printers, 
printer classes, and the default system printer. 

■ If Ipstai is used with no arguments, it reports the status of any 
requests made by the user. 

■ The Ipstai command and common options are shown below: 
$ Ipstat [-cfhst]] f-d] f-pfhst]] f-r] f-t] [-vfhst]] 

Key Operation 

-cflist] Print class names and their member, where list 

is a listing of intermixed printer names and 

class names. 
-d Print the system default printer destination. 

-pflistj Print the status of printers, where list is a 

listing of printer names, 
-r Print the status of the scheduler. 

-/ Print all status information. 

-v[list] Print the names of printers and the path names 

of the devices associated with them, where list 

is a listing of printer names. 
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/usr/h in /cancel 

■ The cancel command cancels printing of the file currently being 
printed, or spooled files when request ID numbers are specified. 

■ The cancel command and common options are shown below: 
$ cancel [ids] [printers] [-a] [-e] [-i] [-uuser] 

Key Operation 

ids Specify the request IDs to be canceled in ids. 

printers Specify the name(s) of printer(s) or printer 

classes where the cancel request is be performed. 
-a Remove all requests a user owns as specified in 

the printers queue, 
-e Empty the spool queue of all requests for the 

printers specified. Only the superuser can use 

the -e option. 
-I Cancel only local requests. 

-uuser Remove any requests queued belonging to user. 

Multiple -u options are allowed; only the 

superuser can use this option. 
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Key 




Operation 






printers 




Specify the name(s) of printer(s 








class or classes 


to be enabled. 


/usr/hin/disc 


ible 







/u s r/b in/enable 

■ The enable command activates the named printer(s), enabling them 
to print requests taken by /usr/bin/lp . This changes the status to 
allow the scheduler to send requests to the printer. 

■ The enable command is shown below: 
$ enable printers 



or printer 



The disable command deactivates the named printer(s), disabling 
them from printing requests taken by /usr/bin/lp . By default, any 
requests that were being printed on the designated printers are 
reprinted in entirety on the same printer, or on another printer in 
the same class. 

The disable command and options are shown below: 

$ disable [-cj [-r[reason]] printers 

Key Operation 

-c Cancel any requests that are currently printing 

on any of the designated printers. 

-rfreason] Associates reason with the deactivation of 

printers. The specified reason will be printed 
when status is requested via the /usr/bin/lpstat 
command, reason must be enclosed in double 
quotes if the reason string contains white space. 

printers Name of printer(s) being deactivated. 
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Administrator Commands 

/usr/lih/lpshut 

■ The Ipshut command shuts down the printer scheduler. 

■ The printers that are printing when Ipshut is invoked will stop 
printing. Any files that are interrupted will reprint in entirety after 
the scheduler is started again by the /usr/lib/lpsched command. 

■ All LP commands perform their functions even when the scheduler 
is not running. Jobs can still be submitted to queues. 

■ The Ipshut command has no arguments and is shown below: 

# Ipshut 



1-116 HP-UX Basics 



Ipadmin 

Configuration changes can be done with Ipadmin: 

■ Add and remove printers. 

■ Change class members. 

■ Change the device associated with the printer. 

■ Assign an interface for a printer. 

■ Assign a system default destination. 

Options to Ipadmin Examples 



-d(dest) 




Assign dest as the system default 
destination. 


-dlaser 


-x(dest) 




Remove destination dest from the 
spooler. 


-xlaser 


-p(printer) 




Selects a printer to which other 
options refer. 


-plaser 


-acluster_ client 


Specify a non-rootserver cnode 








printer. 




To be used 


when the -p( printer) option is selected: 





-g(priority) Sets the default priority (0 - 7) for -g4 

incoming print requests for printer; 
default is 0. 

-c(class) Insert printer as a member of a class. -clp3 

-v( device) Associate device with printer. -v/dev/lpO 

-r(class) Remove printer from a class. -rlp3 

Declaring an Interface Program 

-e(printer) Use existing printer interface. -elp 

-i( interface) Use a new script as interface. -i(path/mk) 

-m(model) See /usr/spool/lp /model . -mhp2563a 
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/usr/hb/ accept 

■ The accept command allows /usr/hin/lp to accept request for the 
named printer or class of printers. 

■ The accept command is shown below: 

% accept destinations 

Key Operation 

destinations Name of a spooled printer (s), printer class 

or classes that /usr/bin/lp is to accept 
requests from. 

/usr/lih/lpsch ed 

■ The Ipsched command schedules request from /usr/hin/lp for 
printing on printers. Ipsched is typically invoked in the /etc/rc 
script at system start-up. 

■ The Ipsched command and options are shown below: 
# Ipsched [-v] [-a] 

Key Operation 

-V Write a verbose record of the Ipsched process on 

/usr/spool/lp/log . 
-a Write Ipana (see lpana{lM)) logging data on 

/usr/spool/lp/lpana.log . 
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Ipmove 

■ The Ipmove command moves requests from one printer to another. 
For example: 

□ Move a specific request to another destination. 

# /usr/lib/lpshut 

if ipmove dp-115 prinier^nam.e 

# /usr/lih/lpsched 

□ Move all destination requests to another destination. 

# /usr/lib/lpshut 

# /usr/lib/reject -r"Down for Repair" printer ..name 

# /usr/lib/lpmove from^printer_name to^printer_name 
:ff: /usr/lib/lpsched 

/u s r/li b/lp move 

■ The Ipmove command moves requests that were queued by 
/usr/hin/lp between printer destinations. 

■ This command may be used only when the scheduler is not running, 
so /usr/lib/lpshut must be invoked prior to using the Ipmove 
command. 

■ Ipmove can move a single request to another printer or class, or all 
requests from one printer or class to another printer or class. 

■ The Ipmove command and arguments are shown below: 
# Ipmove destl dest2 

Key Operation 

destl Request ID(s) to move to dest2. If a printer 

name is specified, all requests queued for that 
printer are moved to dest2. Following this, all 
subsequent requests to destl will be rejected. 

dest2 Name of printer or class of printers where 

requests are to be moved. 
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/usr/hb/rejeci 

m The reject command prevents /usr/bin/lp from accepting requests 
for the named printer or class of printers. 

■ The reject command and options are shown below: 

$ reject f-rfreason]] destinations 

Key Operation 

-rreason Associates reason with preventing /usr/bin/lp 

from accepting requests. If the stated reason 
contains white space it must be enclosed in 
double quotes (for example: "Changing 
Ribbons"). Maximum length of a reason 
message is 80 characters; default is "Reason 
Unknown." 

destinations Name of printer or class of printers from where 
requests are rejected. 
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/usr/lih/lpfe n ce 

■ The Ip fence command defines the minimum priority for which a 
spooled file needs to be printed. 

□ Fence values must be between (lowest fence) and 7 (highest 
fence). Spooled files with a priority equal to or higher than the 
fence will be printed; files with priorities lower than the fence will 
be deferred. 

n Each printer has its own fence setting and is initialized to 
(lowest fence) when configured into the spooling system by the 
/usr/lih/lpadmin command. 

D The Ipfence command may be used only when the scheduler is 
deactivated (using the /usr/lib/lpshut command). 

■ The Ipfence command syntax is shown below: 
# /usr /lib /Ipfence printer fence 

Key Operation 

printer The individual printer or class name where 

fence is set. 
fence Fence priority value (0, lowest priority through 

7, highest priority). 
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/usr/hm/lpalt 

■ The Ipali command alters a printer request that was made by the Ip 
command. New unique ID is returned to standard output. 

■ The Ipalt command and common options are shown below: 

$ Ipalt id f-ddest] f-m] [-nnumber] f-pprtority] [-s] [-ttitlej f-w] 



Key 

id 

-ddesi 



-m 

-nnumber 

-ppnonty 



-t title 

-w 



Operation 

Request ID returned by Ip. This request will be 

altered if not printed. 

File(s) will be printed on dest (the name of a 

printer or printer class). If this key is omitted, 

file(s) will be printed on the default system 

printer. 

Send mail after the file(s) have been printed. 

Print number of copies of the specified file(s). 

Give priority to the print request, priority must 

be an integer between (lowest priority) and 7 

(highest priority) inclusive. The file(s) will be 

printed if equal to or greater than the printer 

fence value; if below the fence, the printout will 

be deferred. 

Suppress messages from Ip such as request ID is 

Print title on the banner page of the output. 
Write a message on the user's terminal after 
file(s) have been printed. 
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2 



HP-UX Installation/Updating 

New Installation of HP-UX— Initial Steps 

■ Read any Read Me First documents and follow directions therein. 
This information supersedes the released manual set. 

■ If you have had previous experience installing HP-UX version 9.0, 
this section should remind you of the key steps and decisions that 
must be made. If you have not had previous experience with the 
installation process please see Installing and Updating HP-UX , HP 
part number B3 108-90006 (for HP-UX version 9.0) for detailed 
instructions. 

■ HP-UX installation consists of the following general steps: 

1. Install the hardware in card locations and verify peripheral 
addresses. Physically connect any additional peripheral devices. 

2. Boot to the ISL> prompt from the Support Tools Media. 

3. Run SS_CONFIG. Set stable storage parameters as required. 

4. Boot from the Install Media. 

5. From the ISL> prompt do the following: 

a. Set primpath to the path of the system disk. 

ISL> primpath BC/X.Y.Z.U 

b. Set alipath to the path of the tape device. 

ISL> altpath BC/X.Y.Z.U 

c. Set auioboot ON. 

ISL> auioboot on 
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d. Type the installation string required for your media. 

For HP-UX version 9.0: 

ISL> hpux install to (BC/X.Y.Z.U) 

Where: BC/X.Y.Z.U is the physical path to the system 
disk. 

For HP-UX version 8.0: 

Consult Installing and Updating HP-UX, HP part 
number 92453-90035 (for HP-UX version 8.0) for correct 
installation string. 

6. The subsections that follow assume that you have begun 
the installation process and must answer a series of system 
specification questions. The questions are presented in the form 
of a checklist. 

7. See Post Installation Guidelines (later in this section) for the 
general steps required to configure the newly installed system. 
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Installation— System Specification Decisions 

The installation process will prompt you with a series of questions 
regarding System Size, the Root File System, Root Size, Swap Size, 
and Type of Filenames. The following will assist you in answering 
these questions. 

Checklist Item Information and Tasks 

System size Continuing the installation, you will see the 

following prompt: 

Do you wish to do a full install 
0-i--Ti> C'-l]? 



The default is Y ; so typing fRetumJ does a full 
installation. If you type N, you respond to 
prompts and get a minimal system for which 
you will need to customize the boot area after 
installation. 



Root file system You get the following prompt: 



D o y o u w i s h t o install a L o g i c a 1 
Volume systeni ':'.y--n> Cy]? 

Accepting the default, Y, installs to a logical 
volume. Typing N installs to a hard partition. 



Root size You get the following prompt: 



Enter Root size in Mega bytes? 
range 164-592 [164]: 

Specifying a larger size (for example, 
180) should be adequate for the root file 
system). Entering a size greater than 200 will 
subsequently prevent the Logical Volume 
Manager from creating logical volumes for file 
systems such as .••'usr. 
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Swap size You get the following prompt: 



Enter Swap size in Mega bytes? 
range 48-136 C48]! 

The 48 MB default is usually adequate. A safer 
rule of thumb for small standalone systems is to 
allocate three times the size of physical memory. 
Size of swap can be determined by determining 
the largest application (look at the manual 
supplies or ask the manufacturer). If the 
customer will be running several applications 
concurrently, you should add their swap 
space requirements together. The maximum 
amount of swap space you can configure (both 
device swap and file system swap combined) is 
approximately 537 Mbytes). 

Type of filenames You get the following prompt: 

Enter file system filenane type? 
long or shorts Cs]5 

The default, s, specifies short filenames. Unless 
you are sure you will be using long filename, 
take the default. It is easy to convert to long 
filenames after the system has been installed at 
a later time using the convertfsflM). Type 1 to 
specify long filenames. 

At this point, the system loads install kernel files and reboots the 
computer. 
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System Reboot and Initial Loading 

Do NOT interrupt the boot process unless the system hangs. While 
the computer boots, remove the Install Media and install Product 
Media on the source drive. 



Logical Volume Installation Continued 

If you have chosen to install HP-UX 9.0 on Logical Volumes, continue 
with this section. If you selected hard disk partitioning see Root Hard 
Partition Installation Continued with follows. 

The following screen shows the default root volume group creation. 



R o o t V o 1 u n e G r o u p C r e -a t i o n 

R o o t V o 1 u Pi e G r o u p ■■■■ d e '•.•■ •••■ '■.•■ 9 8 8 w ill 
b e ere a t e d w i t h t h e f o 1 1 o w i n 9 
conf i9urat ion: 

Logical Volup-ie Size (MB) File System 

.■•■■ d e '•.' ••■■■ '■..' 9 . •■■■ 1 u oil 5 4 

••■■' d e '•.' ■•■■' '•.' 9 ••■■■ 1 '-.' o 12 64 s w a p 

Root VG D i sk ■:: s > Total Size CMB::': 640 
.- ■ d e '...' ■• •■ d s k . •••• c d s 6 640 R y a i 1 a b 1 e ■:: M B > : 72 

OSone instruct ions appear here > 

[ M o d i f y R o o t V o 1 u r-i e G r o up] [Rest a r t ] 
COK] [CANCEL] CHELR] 
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If the values on the screen are acceptable, activate OK. As shown 
below, the install program displays messages about what happens 
and indicates how to continue. If you need to use the options, the 
following sections explain them (Modify Root Volume Group and 
Resiari). 

UPDRTE ON ROOT VOLUME GROUP 

The Physical Volumes will be cre-ated 

< 1 h e r n e s sages -a p p e a r > 

U s e K t o r u n U p d ate, a n d c o n t i n u e 
OK SHELL HELP 

Option: Restart 

Activating this option aborts the installation and lets you start over. 

Option: Modify the Root Volume Group 

The screen looks like this. 

Change Root Volur-ie Group 

C CHANGE FILESYSTEMS] 
[CHhNGE DISKS] 

C CHANGE VG PARflMS] 

OK Cancel Help 
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Checklist Item 

Related Information 



CHANGE 
FILESYSTEMS 



CHANGE DISKS 



CHANGE VG 
PARAMS 



Information and Tasks 

Selecting an option takes you to another screen. 
These screens are not explained; use Help to 
get context-sensitive help within them. 

Provides a screen that lets you modify the 
specifications for file systems (for example, 
you could add ■■-'usr and .•••nnt ). You can 
also modify the swap space. After you make 
changes, activate I'lK to return to the screen for 
Root Volume Group Creation. 

Provides a screen that lets you add or delete 
disks from the specification of disks for the root 
volume group, but you must retain at least one 
disk. It is better to install the root file system 
to one logical volume and, if desired, use SAM 
to add more disks after the installation. After 
you make changes, activate OK to return to the 
screen for Root Volume Group Creation. 

Provides a screen that lets you view the current 
values for logical volume parameters and, if 
desired, modify those values. You can create 
or remove logical volumes in the root volume 
group, but you must retain logical volumes for 
the root file system and swap space. After you 
make changes, activate OK to return to the 
screen for Root Volume Group Creation. 



Root Hard Partition Installation Continued 

This section is to be used if you decided to install the root file system 
to a hard partition on a physical disk. Normally, the default settings 
displayed on the Root Disk Partitioning screen are adequate. If swap 
size is inadequate, changes will be necessary. 
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Partition the Root Disl( If Necessary 

The screen shows the default configuration for your root disk (values 
for parameters such as Section, Size, Section Name, and Section layout 
for boot, directories such as ■••usr, and swap). Exactly what you see 
depends, for example, on your type of disk and its default values. In 
general, the screen looks like this: 



R o o t D i s k P a r t i t i o n i n 9 

Fi len-ar-ie Type Qong or short.':' Isl Disk Type." 179351 

S e c t i o n Size S e c t i o n H -s pi e s S e c t i o n 

■:; M b > < e . 9 . s w a p ? •■■■■ ? . . . ? •■•' e x t r a > L a y o u t 

■:; Inf orr''i.3t ior ) 

Soft key Labels appe-ar -along this line ... 
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Changing the Hard Partitions 

You should read this entire section. Then make modifications as 
necessary. The following checklist items discuss changes you can make: 

Checklist Item Information and Tasks 



Long/Short 
filenames? 

Partition size? 



Swap space? 



The default is short filenames. To have long 
filenames, tab to the field and type 1 over the s. 

The values you see for disk partitioning are 
usually adequate. Do not change them unless 
you have sufficient expertise to know" what to 
specify. 

During an installation, you can install a 
minimal system or more than a minimal system. 
For following items provide guidelines: 

■ Some disks default to 16 MBs on Section 15 
for swap space. This allows only a minimal 
system, which contains the KERN-BLD, 
TOOL, UX-CORE, CORE-SHLIBS, 
CORE-DIAG, C-MIN, EDITORS, and 
CMD-MIN filesets. 

■ The Installing Peripherals document has 
information about the default swap space for 
disks. Be aware that the HP 7914, 7936, 
7958, 7959, 7962B, 7963B, and 9263B disks 
have 16 MBs of swap space. 

■ You must have at least 24 MBs to install 
more than the minimum system. 

■ You can install a minimal system now. Then, 
as a system administrator, you can modify 
the swap space and use update{lM) to add 
other filesets to the system. 
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Root Disk Partitioning Screen Operation 

The section explains how to use the Root Disk Partitioning screen 
to change the names and section locations of the mount points for 
directories such as .•', •■'usr, and ••■•bin into which files are loaded 
during an installation. 

Sections and Directories. 

■ HP-UX divides the physical space on the disk into logical sections 
for the purpose of managing the space eflficiently and flexibly. 

■ Directories have certain sections by default. The Root Disk 
Partitioning screen lets you change the default assignments. 

■ The section to which a directory is assigned determines the size of 
that directory. You can change the size of a directory by moving 
it to another section. The root directory is typically assigned to 
Section 13, which covers the entire disk except for boot and sw-ap. 
This assignment causes update{lM) to load all files into the root 
directory. 

Things to Consider if You Change the Default Configuration. 

■ Looking at the screen, you see that some sections are formed by 
merging smaller sections, which means the same physical space is 
defined twice. (For example, section 11 encompasses sections 10, 3, 
4 and 5 (or 10, 3 and 9). If you use any of these smaller sections, 
you cannot also use section 11 (and conversely) because the update 
program prevents you from using a space twice. You get a warning 
if you have not used all the sections available (for example, if you 
use 3 and 4, but not 5). Make sure all the space on the disk is 
allocated. 

■ Do not leave holes. If you use sections and 14, or and 13, you 
waste disk space (24 MBs on an HP 7935). You get a warning if 
your choice of sections leaves wasted space. 

■ The swap section is not a directory. It is an area of raw storage 
used by the HP-UX memory manager. You must assign at least one 
section to swap, and you can assign multiple sections to swap. 

If you install more than a minimal system at HP-UX Release 9.0, 
you must have at least 24 MBs of swap space. If you have a disk 
with a default swap section of 16 MBs and want to install more 
than a minimum system, assign a swap section of at least 24 MBs. 
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Having multiple sections for file systems has advantages: 

□ Logically related files are stored in contiguous physical space. 
This reduces disk access time. 

n You can tune block/fragment sizes according to the types of file 
in a particular file system. The System. Admimsiration Tasks 
document has information about this. 

n Making the root directory self-contained reduces risk of having 
activity on other disks corrupt the root directory. 

□ You are better protected against root overflow. When the root 
directory is full, the operating system will not work correctly. If 
the root is in a separate section from such directories as •■■tr-ip, 
the root is unaffected if one of these other directories fills up its 
section. 

Having multiple sections for file systems has an disadvantage; 
namely, you might run out of space in a particular section when 
there is ample space elsewhere on the disk. Merging everything into 
one large section eliminates this problem but loses the advantages 
listed above. 

Creating symbolic links can help if you run out of space in a 
particular section. The System Administration Tasks document has 
information about creating symbolic links. 
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Using the Root Disk Partitioning Screen 

The following steps explain how to change the default configuration. 

1. Use (Tab J to move from line to line on the screen. 

2. Space through a default name you want to change, move or delete. 
The boot, •■••■ (root) and sw-bp entities must remain in the list. You 
can have more than one swap area. 

3. Type in a new name where you want it to appear. There are some 
restrictions: 

a. Do not enter duplicate names. Doing so leads to the following 
error: 

ERROR: File systen nar-ies in Section C number] and 
Section Cnur-iber] cannot be identical. 

If you have a duplication, tab to the duplicate, delete it, reenter 
an appropriate entry, tab back to where you were, and continue. 

b. Do not use a section that is overlapped by another already in 
use. 

The line for a given section remains protected (you cannot tab 
to it) when there is an entry for an overlapping section. Clean 
out overlapping sections by spacing through them. 

c. Except for sw-br, enter section names that begin with •••■. 

Do not name sections ■■■'de'-.', ■••"bin, -■lib, or -•'etc. These 
directories must be under the / (root) section. 

If you do, press the space bar and make the indicated correction. 

d. Do not enter section names with embedded spaces. 

If you do, press the space bar and retype the name without 
spaces. 
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e. If you specified short filenames, do not enter section names 
longer than 14 characters. 

If you do, press the spacebar and type a shorter name; or 
enter lin the Fi lename Type field and use long filenames. 
Conversion from short to long file names can be accomplished 
with the convertfs command after installation. 

When you have made desired changes and you think the values on the 
screen are appropriate, you need to continue. Continue by pressing 
P e r f o r r-i Task, which is (fT). 



HP-UX Installation/Updating 2-13 



The Main Menu Continues the Installation 



INSTALL 



Main Menu 



Highlight an iter-i and then press "Return" or 
"Select Iten". To refresh the screen? press CTRL-L. 



Source! Tape De'-.'ice 

..••• I j e I. .1 ..••• 2 1- 1-- , j 5 1. .1 i ,- ( 



Dest i nat i on : Loca 1 Syst er-i 



lect ALL Filesets on the Source Media 
1 e c t Filesets to r a M i n i n u pi S y s t e m - > 
lect .■•••'¥' iew Partitions and Filesets -> 
E n t e r C o d e w o r d - > 



How to Use Install 



Help 



Shel 1 Select 
I ten 



Exit 
Updati 
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Read This Before You Choose a Main Menu Option 

Checklist Item Information and Tasks 



You must eventually 
load filesets 



Do not interrupt the 
loading 



Regardless of which option you choose for 
loading filesets, and regardless of which 
subscreen you use from the Main Menu, you 
must eventually activate Start Loading to 
continue the installation. 

While the system loads filesets, messages appear 
on the screen. They are also recorded in 
.•••■tr-ip.-update. log so you can review them 
after the installation. The loading takes one to 
several hours. 

Install runs When the loading completes, the install 

customization scripts program runs customization scripts for 

individual filesets and builds a new kernel. 

Again, you should not interrupt the system 

during this time. 



Checklist Item 

Install prompts for 
time zone, time, and 
date 

Install prompts 
about networking 



End of an 
installation 



Information and Tasks 

The customize scripts prompt you to enter a 
time zone, time, and date. 



The customize scripts let you specify a 
hostname and an internet protocol address. 
If you get to this point in the installation 
and do not know your hostname and internet 
protocol address, you can continue and set up 
networking later. The System Administration 
Tasks manual explains how to do this. 

Getting a login prompt indicates the 
installation is complete. 
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Is Your Media on a CD-ROM? 

If you install from CD-ROM and you install software other than the 
2-user Runtime product, activate the Enter Codeword -> option. 
You get the following screen. 



Fropi CD-ROM (directory) to Local System 
Modify the desired fields and press "Done". 

S o u r c e D i r e c t o r y : -••■ U P D R T E _ C D R M 

D e s t i n a t i o n D i r e c t o r y : 

C o d e w o r d C e r t i f i c ate: 

Codeword s 

short forr-i 

V e r i f i e d H a r d w are I D : 



Checklist Item Information and Tasks 

Hardware IDs You can get the current hardware IDs on 

your system by highlighting the Verif ied 
Hardware ID and pressing Help. You are not 
allowed to enter anything, you only get the 
information. 

Codeword field Enter the appropriate codeword from your 

CD-ROM Certificate and continue. 
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option 1: Select All Filesets on the Source Media -> 



Checklist Item 

What the option 
does 



St 



an me loaaing 



Information and Tasks 

Selecting Select Rll Filesets on the 
Source Media -> automatically loads every 
fileset on the source media. 



From the Select fill.. 
Start Loadinq. 



screen, activate 



Option 2: Select Filesets for a Minimum System-> 

Activating this option selects the following minimum set of filesets 
(plus the appropriate user license): 



UX-CORE 
KERN-BLD 
TOOL 
CORE-SHLIBS 

Checklist Item 

Related Information 



Load the filesets 



CORE-DIHG 
C-MIN 
EDITORS 
CMDS-MIH 

Information and Tasks 

The Select Filesets for a Minir-iur'-i 
Syster-i screen appears. You can install a 
minimal system now and then, after the 
installation, you can use update [IM) to load 
other filesets. 

Activate Start Lo-ading from this screen. 



Options continue on the next page. 
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Option 3: View/Select Partitions and Fiiesets-> 

The following screen lets you tailor the functionality you load onto the 
svstem. 



V i e w o r S e 1 e c t I ri d i ■■.' i d u a 1 P a r t i t i o n s 



Nark "y" or "n" to nake a selection. 

Press "Main" to return to the partition selection 

screen . 

Se 1 ect Part i t i on Part i t i on Descr i pt i on S i ze Kb 

n D I fl G H S T I C S H a r d w a r e D i a 9 n o sties 3 7 6 6 3 

P HETNORKIHG Networking Products 8919 

y HLS Hati'v'e Language Support 472 

y OS-flDMIH Rec. Rdninistrat ion Cnds 2292 

y OS-CORE Recomn ended Systen Core 5517 

y OS-FEflTURES Selectable OS Features 8176 

y PROG-LflHGUflGES Progranmiing Languages 8542 

y REFEREHCE-DOC Reference Manual Pages 348 

y SHhRED-LIBS Runtime Shared Libraries 2757 

y WINDOWS Windowing Products 102 

Help Shell Start Disk View Global Main 
Loading Space Filesets Select 



Checklist Item 



Information and Tasks 



Using Y, N, and P Y selects and N deselects a partition. If you 
select or deselect filesets in a partition, a P 
appears to indicate a partial selection. 

Update checks The install program does not let you load (or 

dependencies not load) partitions without accommodating 

required dependencies. 

You eventually start After you select or deselect the partitions or 
loading filesets, activate S t a r t L o a d i n g . 
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Post Installation Guidelines 

Essential tasks are: 

■ Setup system security (root password, trusted system, etc.). 

■ Configure peripherals (printers, terminals, disk drives, etc.) into the 
system. 

■ Mount file systems. 

■ Test the LP spooler. 

■ Print /etc/sbiah (9^ Ip /etc/sbtab). 

m Check/configure software subsystems (networking, XI 1 Windows, 
uucp, etc.). 

■ Back up the configured system (fbackup). 

Note For further information, refer to the section After 

- Installing HP-UX in the manual Installing and 

ml Updating HP-UX. HP part number, B3108-90006. 
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HP 9000 Model fxx,Gxx,Hxx,\xx 



F, G, H, I Model Standard Hardware Configuration 
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Figure 2-1. F, G, H, I Model Standard Hardware Configuration 
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• System Disk: 52.6.0 

• System Tape (DDS): 52.0.0 

• Slots 1-12 can be used tor 
other PCAs 

ONOVA.gal 



Note: As of HF^-UX 9.0, the hylultifunction I/O PCA 
used on HP 3000/9x7 systems may be 
used on HP 9000/8x7 systems, Refer 
to 8x7/9x7 CE Handbook for port details. 
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815 Standard Hardware Configuration 
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Figure 2-3. 808/815 Standard Hardware Configuration 



Note 



Slots 9 through 14 in the Model 808 are used to 
enclose the embedded hard disk. 
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HP 9000 Model 822/832/842/852/642/652 

822/832/842/852/642/652 Standard Hardware 
Configuration 
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Figure 2-4. 822/832/842/852/642/652 Standard Hardware Configuration 
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834 Standard Hardware Configuration 
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Figure 2-6. 834 Standard Hardware Configuration 
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635 Standard Hardware Configuration (no Access Port) 
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Figure 2-7. 635 Standard Hardware Configuration (no Access Port) 
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635 Standard Hardware Configuration (Access Port) 
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Figure 2-8. 635 Standard Hardware Configuration (Access Port) 
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645 Standard Hardware Configuration 
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Figure 2-11. 645 Standard Hardware Configuration 
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HP 9000 Model 850/855/860/865/870 



850/855/860/865/870 Standard Hardware Configuration 
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Figure 2-12. 850/855/860/865/870 Standard Hardware Configuration 
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HP 9000 Model 890 



890 Standard Hardware Configuration 
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Figure 2-13. 890 Standard Hardware Configuration 



2-32 HP-UX Installation/Updating 



Updating HP-UX 



NotG B^ aware that to migrate HP-UX from a hard 

- partition on the HP-UX 8.0 release to a root logical 

MM volume on the 9.0 release, you must perform an 

■T installation, NOT an update. If this is your intended 

task, refer to Installing and Updating HP-UX , 
Chapters 1, 2, and 3 for specifics. Do NOT use this 
section. 

■ In contrast to an installation, which overwrites files on the root 
disk, an update provides new functionality without destroying the 
existing system. You must have a functioning HP-UX system to 
perform an update. After performing the update you will probably 
have to edit your customized files or remove certain filesets. 

■ You update HP-UX (as opposed to install) when you have any of 
the following situations: 

n You are running an 8.x release and want to move to the 9.0 
release, keeping your root file system on a hard partition as it is 
now. 

n You are running the 9.0 release and you want to add software to 
that release. 

□ You want to convert an existing system to a network distribution 
server (netdist server). 
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Loading the TOOL Fileset 

If You Have DDS, HP 9114(5), or 9-track Tapes . . . 

1. Write protect the tape according to its documentation. 

2. Insert the tape in its drive. Wait until the drive is ready according 
to the drive's documentation. 

3. Be in the root directory. Execute cd / if necessary. 

4. Execute the following command, which assumes a device file named 
Qpi. You need to specify the appropriate device file name. Wait for 
the extraction to complete before you type anything. After no files 
are extracted for a few minutes, stop the command by typing the 
interrupt key (probably fBreakJ or (CtrlJ -(c)). Otherwise, it can take 
a long time for the command to read the entire tape. 

tar -x'v'f .•■•■de'...'.--rmt.--0p-i TOOL 

If You Have CD-ROM 

1. Be in the root directory. Execute cd / if necessary. 

2. Execute the following command, which assumes the CD-ROM drive 
is mounted under the directory named .••■■UPDflTE_CDROM. If your 
system diff'ers from this, specify the directory where the CD-ROM 
drive is mounted. You get an error message if you do not insert the 
CD-ROM disc or mount the CD-ROM drive (inval id update 
source media). Wait for the extraction to complete. 

tar -xuf .-•■|JPDflTE_CDROM.--TOOL 

Options for loading continue on the next page. 
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If You Use a Netdist Server . . . 

1. Have the netdist server configured and have the update program 
available for clients. 

2. Copy the 9.0 TOOL fileset from the netdist server to the local 
client system. HP recommends using FTP in the anonymous mode. 
The Installing and Administering ARPA Services document has 
information. 

a. Type ftp netdtst_ serve rename (Use the name of the server from 
which you copy .•■' e i c -•■ u p date.) 

b. At the login prompt, type: anonymous 

c. At the password prompt, type: ftp 

d. You should see the f tp> '• prompt. (If you do not, the previous 
steps did not succeed, and you must try again.) 

To extract the fileset, type: 

get dist/TOOL.80Q /tmp/TOOL 

e. You should see messages like this: 

Opening data connection for dist--' ... 
nn bytes rece iued . . . 

f. When the f tp>: prompt reappears, type: bye, which returns 
you to the client system. 

3. From the client system, type: 
cd/ 

4. To complete the extraction, type the following command. Be aware 
several minutes can pass before the first TOOL file is extracted. 
Then, the extraction occurs rapidly. 

tar -xvf /tmp/TOOL 
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starting update 

Having booted HP-UX from the primary boot path and having 
become the root user, start the loading by executing the following 
command: 

/etc/update 

You get a screen like the following one. 



INSTALL 



Main Menu 



Highlight an iter-i and then press "Return" or 
"Select Item". To refresh the screenj press CTRL-L, 



i'Ourcei 



Tape De'v'ice 

•■•■■ d e '■.■'■•■>" Pi t.-'0 Pi 



D e s t i n a t i o n : L o c a 1 S y s t e m 



elect RLL Filesets on the Source Media 
elect Filesets for a Mini nun Systep'i -> 
e 1 ect ■•■■'■,'' i ew Part i t i ons and F i 1 eset s -> 
E n t e r C o d e w o r d - )■ 



How to Use Install 



Help 



Shell 



Delect 
I ten 



Exit 
Update 
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Option 1: Select All Filesets on the Source Media -> 

Selecting Select fill Filesets on the Source Media -> 
automatically loads every fileset on the source media. If you 
activate it, the Select fill... screen appears. At this point, 
if you wish to examine the filesets selected for loading, activate 
Modify. ■■■View Partitions and Filesets, which gives you 
another opportunity to load or deselect filesets. When you are ready, 
activate S t -art L o a d i n 9 . 

Option 2: Select Filesets for a Minimum System-> 

Activating this option causes the following minimum set of filesets 
(plus the appropriate user license) to be selected: 

U X - C R E C R E - D I fl G 

KERH-BLD C-MIH 

TOOL EDITORS 

CORE-SHL I BS CMDS-M I H 

Checklist Item Information and Tasks 

Related Information The Select Filesets for a Mini nun 

Systen screen appears. You can update to a 
minimal system now and then, after the update, 
use update{lM) to load additional filesets. 

Load the filesets Activate Start Loading from this screen. 
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Option 3: View/Select Partitions and Filesets-> 

You can use the following screen to tailor the functionality you load 
onto your system. 



'iew or Select I nd i m i du.Ei 1 P-art it ions 



M.3rk "y" or "n" to PLake a selection. 

Press "M-ain" to return to the partition selection 

screen. 



lie 1 e'_t 



P-ar t i t i on P-art i t i on Descr i pt i on S i ze Kb 



n D I H U H S T I C S H .a r d w a r e D i a y n o s t i c s 

P HETNORKING Networking Products 

y H L S H .a t i >...< e L a n 9 u a y e S u p p o r t 

y OS- ADM I H Rec. Rdninistr.at ion Cmds 

y OS-CORE Re comr-i ended Systen Core 

y OS-FERTURES Select .able OS Fe.atures 

y P R G - L fl H G U R G E S P r o 9 r a m n i n 9 L a n 9 u ages 

y REFEREHCE-DOC Reference htanual Pages 

y SHRRED-LIBS Runtime Sh-ared Libraries 

y WINDOWS Windowing Products 



37663 


3919 


472 


21l:9I:::I 


5517 


3176 


3542 


343 


■"■ "7 !=: "7 



102 



Help Shell Start Disk View Global Main 
Loading Sp.ace Filesets Select 



Checklist Item 

Using Y, N. and P 



Update checks 
dependencies 



Information and Tasks 

Y selects and N deselects a partition. If you 
select or deselect filesets in a partition, a P 
appears to indicate a partial selection. 

The install program does not let you load (or 
not load) partitions without accommodating 
required dependencies. 



You eventually start After you select or deselect the partitions or 
loading filesets , activate S t a r t L o a d i n g . 
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Reconfirm Having Enough Disl( Space 

Your current system might need to grow to accommodate your 9.0 
products. If you do not have enough space, you have two alternatives. 

1. Free up disk space on your existing system, or 

2. Shut down your system, add another disk (or disks), restart the 
system, and perform the update. 

How to Free Disk Space 

1. Deselect filesets to load during an update. 

2. Remove some existing files on the system. 

3. Mount another file system. 

4. Create symbolic links. 

5. Use a combination of the above methods. 
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Fixing Overflow with Symbolic Links 

■ A symbolic link transparently links a file or directory to another 
file or directory. This is often used when a file system overflows. 
On overflow, all the files in a selected directory are moved to a 
new directory on a new file system. The original directory is then 
symbolically linked to the new directory where the data then 
resides. The user can access the data using the original path name 
(using the symbolic link) or directly using the new path name. 

■ The /bin /In command and parameters required to link one directory 
to another are shown below: 

^ In -s new^directory old^directory 

Key Operation 

-s Causes In to create a symbolic link. 

new^directory Full path name of new directory where the 

moved files reside. 
old_directory Full path name of original directory where 

files resided previously. 



Example: 

# mkdir /mnt/users 

# cp -rp /users/* /mnt/users && rm -rf /users/* 

# In -s /mnt/users /users 
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Remove Unwanted Software Using rmfn(1M) 

After you finish installing HP-UX, you might have software you do not 
need. The rm/n(lM) (remove functionality) utility lets you remove 
unnecessary system software. The HP-UX Reference manual has 
complete information for this command. 

Use rmfn with CautioiT 

Although rmfn{lM) checks dependencies to prevent you from 
inadvertently removing functionality, you still need to be cautious. 
The command is designed to help you quickly remove major pieces of 
software. It is important to avoid making mistakes. 



Important Points About Using rmfn(1M) 

Checklist Item Information and Tasks 



Filesets and 
partitions 



Dependencies 



Remote systems 
Symbolic links 



The filesets and partitions that the rnit n 
command displays depend on the contents of 
the directories named ■■■'eic-'i' i lesets and 
■■■■syster'i. Do not change the contents of these 
directories or the command will display an 
inaccurate list of filesets. 

The rm/n (IM) command only lets you remove 
filesets that will not subsequently harm the 
integrity of your system. The rm/n(lM) 
command does not allow you to remove a 
minimum set of filesets needed by the system. 
For example, you cannot remove UX-CORE. 

The rm/n (IM) command does not remove files 
on a remote, mounted system (NFS). 

As the rm/n (IM) command removes a symbolic 
link contained in a fileset, it does not remove a 
symbolic link's target file. A target file remains 
intact until rm/n (IM) removes the fileset 
containing the target file. 
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How to Use rmfn 

To use the remove fileset command, log in a system administrator and 
execute: 

a^/ etc /rmfn 

The example below shows a typical main screen. 



rr-itn 



Part it ions 



Press "y" to select an entire partition for deletion. 
Press "n" to undo a selection. Press the "Select 
Filesets" key to ■■.•■iew the filesets within a 
partition. Press the "Start Renoying" key when 
se 1 ect i on i s cor-ip 1 et e . 



Mark 








Part 


. 


Rrc 


P 


DIRGNOSTICS 


380 


n 


NETWORKING 


380 


n 


NLS 


300 


n 


o:: 


;;-RDMiN 


300 


n 


0:: 


:-CORE 


300 


n 


0:: 


:;-FEflTURES 


300 


y 


PF 


::OG-LflNG. 


300 


n 


REFERENCE-DOC 


388 


n 


SHRRED-LIBS 


388 


n 


W] 


[NDOWS 


300 



Rrch. Part. Desc. 



H a r d w a r e D i a 9 n o sties 
N e t w o r k i n 9 P r o d u c t s 
N a t i '...' e Lang. S u p p o r t 
R e c o n n ended fl d m i n . C n d s 
R e c o n n e n d e d S y s t e n C o r \ 
Selectable OS Features 
P r o 9 r a pi n i n g L a n g u ages 
Reference Manual Pages- 
Runt ine Shared Libs 
W i n d o w i n g P r o d u c t s 



bize 


Kb. 


37663 


8919 


472 


2292 


5517 


S176 



8542 
348 

2757 
102 



[Help] 



[Shell] [Start Ren] 



The following page explains the options and use. 
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Checklist Item 

Arrow keys 

© 

Help 
Shel 1 

Exit rpifn 
lect Filesets 

V i e w S e 1 e c t e d 



Information and Tasks 

Move the highlight among the items in a screen 
as impUed by the key. 

This key selects a highlighted item for deletion. 
The letter y appears on the screen under M-ark . 

This key undoes the effects of a selection. For 
example, if you select a partition with (y), 
pressing (n3 deselects the partition. The letter n 
appears on the screen under M.ark . 

Pressing this softkey explains how to use the 
rr-ifn command. 

Pressing this softkey lets you escape to a shell 
to execute HP-UX commands. Type exit on 
a shell command line to return to the rr-if n 
screen. 

Pressing this softkey terminates the removal 
process and exits the rmf n command. 

For a highlighted partition, pressing this 
softkey lets you select individual filesets in 
that partition for deletion. If you do this, a p 
appears on the screen under M-ark to indicate a 
partial selection of filesets. 

Pressing this softkey lists the names and sizes of 
the partitions and filesets selected for removal. 



; t a r t R e m o '•.•■ i n g Pressing this softkey removes the selected 
partitions and filesets from your system. 
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HP-UX version 8.0 Boot Paths and Installation 
Commands 

■ This section is included to assist individuals in installing HP-UX 
release 8.0. 

CdUtion Do NOT use information in this section when 

• installing HP-UX version 9.0. The information 

presented here is NOT compatible with HP-UX 
version 9.0. Refer to Installing HP-UX earlier in this 
section for 9.0 installation information . 

■ For specifics on installing HP-UX version 8.0 on models or 
configurations not included in this section, see the manual Installing 
and Updating HP-UX, HP part number 92453-90035. 
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808/815 Boot Paths and Installation Commands 

• Installation of the 808/815 (with Mag Tape Drive) 



HP-IB Card 
(Slot 5, Module No. 20) 


Installation Commands 
and Boot Paths 


System Disk: Address 
Mag Tape Drive: Address 4 


Command to Boot from Tape: 
hpux -a (20.0) (20.4;0xa0000,l) 
Primary Boot Path: 20.0^ 

Alternate Boot Path: 20.4^ 



1 Default boot path. 

• Installation of the 808/815 (with Cartridge Tape Drive) 



HP-IB Card 


Installation Commands 


(Slot 5, Module No. 20) 


and Boot Paths 


System Disk: Address 


Command to Boot from Tape: 


Cartridge Tape Drive: Address 3 


hpux -a (20.0) (20.3;0x400000) 




hpux (20.3;0x400000) 




hpux install 




Primary Boot Path: 20.0^ 




Alternate Boot Path: 20.3^ 



1 Default boot path. 
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822/832/842/852/642/652 Boot Paths and Installation 
Commands 

• Installation of the 822/832/842/852/642/652 (with DDS) 



HP-IB Card 


Installation Commands 


(Slot 11, Module No. 44) 


and Boot Paths 


System Disk: Address 


Command to Boot from Tape: 


DDS Drive: Address 7 


hpux -a (44.0) (44.7:OxaOOOO,l) 




hpux (44.7;0xa0000J) 




hpux install 




Primary Boot Path: 44.0^ 




Alternate Boot Path: 44.7-^ 



1 Default boot path. 

• Installation of the 822/832/842/852/642/652 (with Cartridge Tape 
Drive) 



HP-IB Card 
(Slot 11, Module No. 44) 


Installation Commands 
and Boot Paths 


System Disk: Address 
Cartridge Tape Drive: Address 3 


Command to Boot from Tape: 
hpux -a (44.0) (44-4:0x400000) 




hpux (44.4;Ox400000) 




hpux install 

Primary Boot Path: 44.0^ 

Alternate Boot Path: 44.3^ 



1 Default boot path. 
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825/835 Boot Paths and Installation Commands 

• Installation of the 825/835 (with Mag, or DDS Tape Drive, no 
Access Port, all Consoles) 



CIO Configuration 


Installation Commands 




and Boot Paths 


CIO Slot 0: 


Command to Boot from Tape: 


HP-IB/HP-FL device adapter 


hpux install 


with system disk at Address 


or 




hpux -a (4.0.0) (4.2.3;0xa0000,l) 


CIO Slot 2: 


or 


HP-IB device adapter with mag, 


hpux (4.2.3;0xa0000,l) 


or DDS tape drive at Address 3 


Primary Boot Path: 4.0.0^ 




Alternate Boot Path: 4.2.3^ 



1 Default boot path. 

• Installation of the 825/835 (with Mag, or DDS Tape Drive, Access 
Port, all Consoles) 



CIO Configuration 


Installation Commands 




and Boot Paths 


CIO Slot 0: 


Command to Boot from Tape: 


Access Port (AP) 


hpux install 


CIO Slot 1: 


hpux -a (4.1.0) (4.2.3;0xa0000,l) 


HP-IB/HP-FL device adapter 


or 


with system disk at Address 


hpux (4.2.3;0xa0000,l) 




Primary Boot Path: 4.1.0^ 


CIO Slot 2: 


Alternate Boot Path: 4.2.3^ 


HP-IB device adapter with mag, 




or DDS tape drive at Address 3 





1 Default boot path. 
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• Installation of the 825/835 (with CTD, no Access Port, 
Non-Graphics Console) 



CIO Configuration 


InstaUation Commands 




and Boot Paths 


CIO Slot 0: 


Command to Boot from Tape: 


HP-IB/HP-FL device adapter 


hpux-a (4.0.0) (4.6.3:0x400000) 


with system disk at Address 


or 




hpux (4.6.3;0x400000) 


CIO Slot 6: 


Primary Boot Path: 4.0.0^ 


HP-IB device adapter with 


Alternate Boot Path: 4.6.3^ 


CTD at Address 3 





1 Default boot path. 

• Installation of the 825/835 (with CTD, Access Port, Non-Graphics 
Console) 



CIO Configuration 


Installation Commands 
and Boot Paths 


CIO Slot 0: 
Access Port (AP) 


Command to Boot from Tape: 
hpux-a (4.1.0) (4.6.3;0x400000) 


CIO Slot 1: 

HP-IB/HP-FL device adapter 

with system disk at Address 


hpux (4.6.3:0x400000) 
Primary Boot Path: 4.1.0^ 
Alternate Boot Path: 4.6.31 


CIO Slot 6: 

HP-IB device adapter with 

CTD at Address 3 





1 Default boot path. 
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• Installation of the 825/835 (with CTD, no Access Port, Graphics 
Console) 



CIO Configuration 


Installation Commands 




and Boot Paths 


CIO Slot 0: 


Command to Boot from Tape: 


HP-IB/HP-FL device adapter 


hpux -a (4.0.0) (4.5.3,0x400000) 


with system disk at Address 


or 




hpux (4.5.3;0x400000) 


CIO Slot 5: 


Primary Boot Path: 4.0.0^ 


HP-IB device adapter with 


Alternate Boot Path: 4.5.3^ 


CTD at Address 3 





1 Default boot path. 

• Installation of the 825/834/835/845/635/645 (with CTD, Access 
Port, Graphics Console) ' 



CIO Configuration 


Installation Commands 
and Boot Paths 


CIO Slot 0: 
Access Port (AP) 


Command to Boot from Tape: 
hpux -a (4.1.0) (4.5.3;0x400000) 


CIO Slot 1: 

HP-IB/HP-FL device adapter 

with system disk at Address 


hpux (4.5.3;0x400000) 
Primary Boot Path: 4.1.0^ 
Alternate Boot Path: 4.5.3^ 


CIO Slot 5: 

HP-IB device adapter with 

CTD at Address 3 





1 Default boot path. 
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• Installation of the 825/835 (with CTD, no Access Port, A1074A GAI 
Card) 



CIO Configuration 


Installation Commands 




and Boot Paths 


CIO Slot 0: 


Command to Boot from Tape: 


HP-IB/HP-FL device adapter 


hpux -a (4.0.0) (4.2.3;0x400000) 


with system disk at Address 


or 




hpux (4.2.3,0x400000) 


CIO Slot 2: 


Primary Boot Path: 4.0.0^ 


HP-IB device adapter with 


Alternate Boot Path: 4.2.3^ 


CTD at Address 3 





1 Default boot path. 

• Installation of the 825/835 (with CTD, Access Port, A1074A GAI 
Card) 



CIO Configuration 


Installation Commands 
and Boot Paths 


CIO Slot 0: 
Access Port (AP) 


Command to Boot from Tape: 
hpux -a (4.1.0) (4.5.3;0x400000) 


CIO Slot 1: 

HP-IB/HP-FL device adapter 

with system disk at Address 


hpux (4.5.3:0x400000) 
Primary Boot Path: 4.1.0^ 
Alternate Boot Path: 4.5.3^ 


CIO Slot 5: 

HP-IB device adapter with 

CTD at Address 3 





1 Default boot path. 
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834 Boot Paths and Installation Commands 

• Installation of the 834 (with CTD, no Access Port, all Consoles) 



CIO Configuration 


Installation Conunands 




and Boot Paths 


CIO Slot 0: 


Command to Boot from Tape: 


HP-IB/HP-FL device adapter 


hpux install 


with system disk at Address 


or 




hpux -a (i.0.0) (I2.3;0x400000) 


CIO Slot 2: 


or 


HP-IB device adapter with 


hpux (4. 2. 3; 0x400000) 


CTD at Address 3 


Primary Boot Path: 4.0.0^ 




Alternate Boot Path: 4.2.3^ 



1 Default boot path. 
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635 Boot Paths and Installation Commands 

• Installation of the 635 (with Mag, or DDS Tape Drive, no Access 
Port, all Consoles) 



CIO Configuration 


Installation Commands 




and Boot Paths 


CIO Slot 0: 


Command to Boot from Tape: 


HP-IB/HP-FL device adapter 


hpux install 


with system disk at Address 


or 




hpux -a (4.0.0) (8.2.3;0xa0000,l) 


CIO Slot 2: 


or 


HP-IB device adapter with mag. 


hpnx (4.2.3;0xa0000,l) 


or DDS tape drive at Address 3 


Primary Boot Path: 4.0.0^ 


. 


Alternate Boot Path: 4.2.3^ 



1 Default boot path. 

• Installation of the 635 (with CTD, no Access Port, all Consoles) 



CIO Configuration 


Installation Conunands 




and Boot Paths 


CIO Slot 0: 


Command to Boot from Tape: 


HP-IB/HP-FL device adapter 


hpux install 


with system disk at Address 


or 




hpux -a (4.0.0) (8.2.3:0x400000) 


CIO Slot 2: 


or 


HP-IB device adapter with 


hpux (4.2.3:0x400000) 


mag tape drive at Address 3 


Primary Boot Path: 4.0.0^ 




Alternate Boot Path: 4.2.3^ 



1 Default boot path. 
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• Installation of the 635 (with Mag Tape Drive, no Access Port, all 
Consoles) 



CIO Configuration 


Installation Commands 




and Boot Paths 


CIO Slot 1: 


Command to Boot from Tape: 


HP-IB/HP-FL device adapter 


hpux install 


with system disk at Address 


or 




hpux -a (4.1.0) (4.2.3;0xa0000,l) 


CIO Slot 2: 


or 


HP-IB device adapter with 


hpux (4.2.3;0xa0000,l) 


mag tape drive at Address 3 


Primary Boot Path: 4.1.0^ 




Alternate Boot Path: 4.2.3^ 



1 Default boot path. 

• Installation of the 635 (with CTD, Access Port, all Consoles) 



CIO Configuration 


Installation Commands 




and Boot Paths 


CIO Slot 1: 


Command to Boot from Tape: 


HP-IB/HP-FL device adapter 


hpux install 


with system disk at Address 


or 




hpux -a (4.1.0) (4.2.3;0x400000) 


CIO Slot 2: 


or 


HP-IB device adapter with 


hpux (4.6. 3;0x400000) 


mag tape drive at Address 3 


Primary Boot Path: 4.1.0^ 




Alternate Boot Path: 4.6.3^ 



1 Default boot path. 



HP-UX Installation/Updating 2-53 



845/645 Boot Paths and Installation Commands 

• Installation of the 845/645 (with Mag, or DDS Tape Drive, no 
Access Port, all Consoles) 



CIO Configuration 


Installation Commands 




and Boot Paths 


CIO Slot 0: 


Command to Boot from Tape: 


HP-IB/HP-FL device adapter 


hpux install 


with system disk at Address 


or 




hpux -a (8.0.0) (8.2.3;0xa0000J) 


CIO Slot 2: 


or 


HP-IB device adapter with mag, 


hpux (8.2.3:0xa0000,l) 


or DDS tape drive at Address 3 


Primary Boot Path: 8.0.0^ 




Alternate Boot Path: 8.2.3^ 



1 Default boot path. 

• Installation of the 845/645 (with CTD, no Access Port, all Consoles) 



CIO Configuration 


Installation Commands 




and Boot Paths 


CIO Slot 0: 


Command to Boot from Tape: 


HP-IB/HP-FL device adapter 


hpux install 


with system disk at Address 


or 




hpux -a (8.0.0) (8.2.3:0x400000) 


CIO Slot 2: 


or 


HP-IB device adapter with 


hpux (8.2.3:0x400000) 


CTD at Address 3 


Primary Boot Path: 8.0.0^ 




Alternate Boot Path: 8.2.3^ 



1 DefaiJt boot path. 
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• Installation of the 845/645 (with Mag, or DDS Tape Drive, Access 
Port, all Consoles) 



CIO Configuration 


Installation Commands 




and Boot Paths 


CIO Slot 0: 


Command to Boot from Tape: 


HP-IB/HP-FL device adapter 


hpux install 


with system disk at Address 


or 




hpux -a (8.1.0) (8.2.3;0xa0000J) 


CIO Slot 2: 


or 


HP-IB device adapter with mag. 


hpux (8.2.3;0xa0000,l) 


or DDS tape drive at Address 3 


Primary Boot Path: 8.1.0^ 




Alternate Boot Path: 8.2.3^ 



1 Default boot path. 

• Installation of the 845/645 (with CTD, Access Port, all Consoles) 



CIO Configuration 


Installation Commands 




and Boot Paths 


CIO Slot 0: 


Command to Boot from Tape: 


HP-IB/HP-FL device adapter 


hpux install 


with system disk at Address 


or 




hpux -a (8.1.0) (8.2.3;0x400000) 


CIO Slot 2: 


or 


HP-IB device adapter with 


hpux (8.2.3;0x400000) 


mag tape drive at Address 3 


Primary Boot Path: 8.1.0^ 




Alternate Boot Path: 8.2.3^ 



1 Defavdt boot path. 
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850/855/860/865/870 Boot Paths and Installation 
Commands 

• Installation of the 850/855/860/865/870 (with Mag Tape Drive) 



CIO Configuration 


Installation Commands 




and Boot Paths 


CIO cardcage 0_1, slot 0: 


Command to Boot Tape: 


HP-IB/HP-FL device adapter 


hpux install 


with system disk at Address 


or 




hpux -a (2/4.0.0) \ 


CIO cardcage 0_1, slot 2: 


(2/4.2.3;0x0a0000,l) 


HP-IB/HP-FL device adapter 


or 


with system disk at Address 3 


hpux (2/4.2.3;0x0a0000,l) 




Primary Boot Path: 2/4.0.0^ 




Alternate Boot Path: 2/4.2.3^ 



1 Default boot path. 

• Installation of the 850/855/860/865/870 (with CTD) 



CIO Configmration 


Installation Commands 




and Boot Paths 


CIO cardcage 0_1, slot 0: 


Command to Boot from Tape: 


HP-IB/HP-FL device adapter 


hpux install 


with system disk at Address 


or 




hpux -a (2/10.0) \ 


CIO cardcage 0_1, slot 2: 


(2/12.3:0x400000) 


HP-IB/HP-FL device adapter 


or 


with CTD at Address 3 


hpux (2/4.2.3:0x400000) 




Primary Boot Path: 2/4.0.0^ 




Alternate Boot Path: 2/4.2.3^ 



1 Default boot path. 
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Diagnostics and Support Tape 

HP-UX 9.0 Diagnostic Passwords 

Beginning with HP-UX release 9.0, most diagnostics and support tools 
that run on HP 9000 Series 600/800 systems require a password. 

Before invoking the Diagnostic User Interface (DUI) or the 
Support Wave Support Tools Manager, enter a password using the 
suplicen command. 

Individual HP 9000 Series 600/800 off-line diagnostics and utilities 
distributed on the Support Tape are also passworded beginning with 
HP-UX release 9.0. When these diagnostics and utilities are run from 
the Support Tape's ISL prompt, the user will be prompted for a 
password. Once a correct password has been entered, the diagnostics 
and utilities run in the conventional manner. 



Diagnostic Categories 

■ HP 9000 Series 600/800 on-line diagnostics are now divided by 
licensing requirements into three categories. 



NO 
CHARGE 



Diagnostics available with no password 



LICENSED Diagnostics available to customers with a password 

HP USE Diagnostics and utilities available for 

ONLY Hewlett-Packard support personnel ONLY. 

Password required. 
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No Charge Diagnostics 

■ The following on-line diagnostics are available at no charge to 
customers. 

LOGTOOL System logging tool 
SYSMAP System mapping tool 
VERIFY Svstem verification tool 



■ The following off-line utility is available at no charge to customers. 

lOMAP Maps system hardware from the ISL prompt 

Diagnostic Password Types 

■ There are four types of diagnostic passwords. 
HP INTERNAL Unlocks all diagnostics. 

CLASS Unlocks diagnostics for classes of systems (such as 

lower end system, mid range, and high end system). 
Valid for six months. 

SYSTEM Unlocks licensed diagnostics in certain high security 

SPECIFIC situations. A customer using these passwords will 

require a password for each system (introduction in 

mid 1993). 

TEMPORARY Unlocks licensed diagnostics for 1 to 20 days. 



Entering the Password 

■ After root logon, enter the diagnostic peissword using the suphcen 
command. 

# suphcen 

Enter the diagnostic password when prompted. Once this has been 
accomplished, run sysdiag. 



3-2 Diagnostics and Support Tape 



Diagnostic User Interface (DUI) 



User 



► Log File 



DUI 



Diagnostic 
Programs 



On-line Diagnostics Portability Interface 



Operating Systern 



I/O .9\/Qtpm 



Devices 



UNXA0601 1/89 

Figure 3-1. HP-UX On-line Diagnostic Subsystem 
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Running DUI 

■ DUI is invoked by running sysdiag. 
# sysdiag 



■S- T^ ■S' "S- •S- -S- ■S ■i'r it ■!(• ■S" -S- 

****** ONLINE DIRGNOSTIC SYSTEM ****** 

****** ****** 

****** <c> Copyright Hewlett Packard Co. ****** 

****** 1987, 1989, 1990, 1992 ****** 

****** fill Rights ReserMed ****** 

****** ****** 

****** DUI Version H.02.21 ****** 

****** Diagnostic Monitor Version fi.02.19 ****** 

****** ****** 



Type "HELP" for assistance. 
DUI > 

Key DUI Commands 

HELP Gives help on commands, syntax, and diagnostic 
descriptions. 

LIST Lists the diagnostics available on the system, 

diagnosable HP product numbers, etc. 

RUN Runs the specified diagnostic. 
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HELP 

• DUI> HELP 

The following is a partial list of commands available in DUI . 
Information about a particular command can be obtained by typing 
HELP followed by the command name. 

Command Description 

ABORT Abort a diagnostic system program. 

CI Invoke the system command interpreter. 

DO Re-execute a command. 

EXIT Exit the DUI. 

HARDCOPY Echo input/output data to a hardcopy device. 

HELP Help facility. 

INSTALL Add a program to the diagnostic system. 

LIST Display information on installed programs. 

LISTREDO Display the command history stack. 

OUTFILE Echo input/output to a file. 

REDO Edit and re-execute a command. 

RUN Run a diagnostic system program. 

UNLOCK Unlock a malfunctioning locked device. 

Diagnostic Descriptions. 

•To obtain a diagnostic's functional description enter 
HELP diagnosUc^name. Example: 

DUI > HELP flexdiag 
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LIST 

■ To list all diagnostics 
DUI > LIST 



Enter the fvdl directory path in which the programs axG 

installed. 

[<cr> /usr/diag/bin] : 



AFIDAD 

CONSOLAN 

DTDUTIL 

GS2DDIAG 

HPIBDDS 

LOGTOOL 

OSIDAD 

REELDIAG 

SCSIDISK 

SS80DIAG 



CARTDIAG 

CS80DIAG 

FLEXDIAG 

GS3DDIAG 

HPIBDIAG 

MEMDIAG 

PMUXDIAG 

SCSICD 

SCSIPBA 

SYSMAP 



CENTPBA 

DASSDIAG 

GP3DDIAG 

HPFLDIAG 

LAN3PBB 

MUXDIAG 

PRNT5000 

SCSICIO 

SCSIQIC 



CIPERLPD 

DIAG7478 

GPIODAD 

HProOAD 

LANDAD 

OPDIAG 

PSIDAD 

SCSIDDS 

SCSIREEL 



To view the products diagnosed by a specific diagnostic, enter list 
long diagnostic^name . Example: 

DUI > LIST LONG flexdtag 

Enter the full directory path in which the programs are insteJled. 
[<cr> /usr/diag/bin] : 



Nautne 



Program Program 
Version Type 



Catzdog 
L£inguages 



Devices 



FLEXDIAG A.02.15 DIAGNOSTIC n-computer HP7936FL 

HP7937FL 
HPC2201A 
HPC2204A 
HPC2251S 
HPC2252B 
HPC2252HA 
HPC2254 
HPC2254HA 



3-6 Diagnostics and Support Tape 



To find a diagnostic for a product. 

DUI > list product^number 

product^number = HP product number of the device to be 
diagnosed 



RUN 

■ The run command and common command modifiers are shown 
below. 

DUI > [RUN] diagnostic [command^modifier 
[command_modifier] ... 7 

Where: 

diagnostic Name of diagnostic to execute 

command_modifier: pdev = physical path to device 

sections = section range list 

steps = step range list 

errcount = number 

loopcount = number 

background 

erronly 

errpause 

DUI RUN Example. 

•DUI > RUN SCSIDISK PDEV =52. 6.0 \ 
SECTIONS=10 L00PC0UNT=2 ERRCOUNT=10 

This command runs scsidisk on the disk located at physical path 
52.6.0 . The diagnostic will run section 10 twice unless the error 
count exceeds 10. 
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Frequently Used DUI Commands 

■ REDO 

Allows editing and execution of a previous command. 

■ HARDCOPY [ ON | OFF ] 

Prints screen information on a printer. Hardcopy ON begins 
storing information into a print file. Hardcopy OFF places an 
end of file mark on the data and sends the completed print file to 
the LP spooler to be printed. 

■ OUTFILE [ filename | OFF ] 

Copies all information displayed on the screen to a file on disk. 
Outfile filename begins storing information into filename . Outfile 
OFF writes an end of file mark and closes filename. 

m ABORT 

Aborts diagnostic (PID required). 

■ CI 

Suspends DUI; returns to HP-UX shell, exit returns to DUI. 

Obtaining Diagnostic Sectioning information 

• DUI 10> HELP CS80DIAG SECTIONS 
The following sections are available: 

DEFAULT 

Section 10 Diagnostic Trouble Tree — This section will execute 

the fault isolating diagnostic trouble tree. 

Section 17 External Exerciser — This section provides the user 

with interactive access to the disk drive's internal 
diagnostics and utilities. 
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DUI > LOGTOOL 
•DUI > LOGTOOL 

LOGTOOL (System and Memory Log Analysis Tool) is 

useful in troubleshooting intermittent problems. It provides the 

following: 

■ System log files for both hardware and software. 

■ Memory log files for logging priority errors. 

■ Log file maintenance commands — Clear, Delete, and Switch. 

■ Log file decoding and display. 

Miscellaneous LOGTOOL Commands 

■ DISPLAYLOG 

Display I/O entries cis information is logged. (This command may 
appear to be hung since it is waiting for realtime I/O entries) 

■ EXIT 

Exit LOGTOOL, and return to DUI. 
m HELP 

Help about running LOGTOOL. 
m REDO 

Edit the last line of text entered. 
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LOGTOOL System Logfile Commands 

■ LIST 

Lists the contents of closed system log file(s). (see SWITCHLOG 
below) 

■ PURGESYSLOG 

Delete the specified system log file(s). 

■ PURGEWORK 

Delete specified work files from the disk. 

■ SELECT 

Select specified records from system log files. 

■ STATUS [detail] 

Report on the status of all system log files. An asterisk (*) 
indicates the current or active log file being logged to. Status 
DETAIL displays log file starting date/time, number of records in 
log, etc. 

■ SWITCHLOG 

Cause the system to close the active log file and start a new one. 
This command must be executed to see the latest information 
logged using the LIST command. 

■ TYPES 

Description of system log file types. 

Examining tlie Current LOGTOOL System Log 

■ To read the latest system log file: 

LOGTOOL> STATUS DETAIL (note the bottom log number) 

LOGTOOL> SWITCHLOG 

LOGTOOL> LIST LOG=lognumher {lognumber is the bottom log 
number found with status detail above) 
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DUI > SYSMAP 
•DUI > SYSMAP 

SYSMAP provides on-line system configuration informa- 
tion in the following output maps: 

■ CPU MAP 

Data includes information about CPUs, coprocessors, and caches. 

■ MEMMAP 

Data includes information about controller and array sizes, 
interleaved status, and enabled status. 

■ MODULEMAP 

Data includes information about CPUs, memories, graphic cards, 
and other modules that reside on the system bus. 

■ 10 MAP 

A map of all I/O devices configured into the system having 
CONFIRM mode On; shows devices actually connected. 
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SupportWave 

Support Wave is an integrated support tools platform that provides a 
single point access for: 

■ Diagnostics 

□ Diagnostics provide the capability to interact with the device 
firmware, and to perform other tests. Diagnostics are expected 
to provide problem isolation to the field replaceable unit (FRU) 
level. When invoked from the Support Tool Manager, diagnostics 
execute their built-in trouble tree. Diagnostics can also be 
invoked in an expert mode and individual tests run. 

■ Verifiers 

n Verifiers provide a simple test of the component to give a go/no 
go answer, indicating whether it is functioning correctly. 

■ Exercisers 

n Exercisers provide the ability to provide continuous stress on the 
system or subsystem. This is useful to provide robust verification, 
and to help isolate intermittent errors. 



Running SupportWave 

Support Wave has three interfaces, each is called Support Tool 
Manager. 

■ To run the graphical user interface called XSTM on an XI 1 
windows terminal: 

# /bin/xstm 

■ To run the command line interface called CSTM: 

# /hin/csim 

■ To run the menu interface called MSTM: 

# /hin/msim 



3-12 Diagnostics and Support Tape 



Running SupportWave's Command Line Interface (CSTM) 

■ CSTM is invoked by running cstm. 
# cstm 



****** ****** 

****** SUPPORT TOOLS MflNRGER ****** 

****** CofiPiarid Line Interface ****** 

****** ****** 

****** Version R.OS.IS ****** 

****** ****** 

****** Part Hupiber 624730-19002 ****** 



!C> Copyright Hewlett Packard Co. ****** 

fill Rights Reser'v'ed ****** 



^^^^^^ 



****** DUI Version R.02.21 ****** 

****** This progran is intended for use by ****** 
****** trained HP support personnel only. ****** 



Please type HELP or ? to list available comr-iands. 
CSTM> 
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Key CSTM Commands 

HELP Displays the help menu or specific 

information on a specified command. 

MAP Display a map of system devices. 

DIAGNOSE Use to diagnose a specified device. 

EXERCISE Use to exercise a specified device. 

VERIFY Use to verify a specified device or ALL 

devices 

HELP 

• CSTM> HELP 

The following is a partial list of commands available in CSTM . 
Information about a particular command can be obtained by typing 
HELP followed by the command name. 

Command Description 

ABORT Abort a all currently executing processes and 

exit. 

CI Escape to the shell, exit returns to CSTM. 

DIAGNOSE Diagnose a specified device. 

EXIT Wait for all currently executing processes to 

complete and then exit. 

EXERCISE Exercise a specified device. 

HELP Display this help menu or more specific 

information on a specified command. 

MAP Display a map of system devices. 

TIME Set a default time value (how many minutes the 

test should run). 

VERIFY Verify a specified device or ALL devices. 

VIEWLOG View the session loe or test results loe. 
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CSTM Run Examples. 

•CSTM> VERIFY CPU 

This command runs verifies the cpu. 

•CSTM> DIAGNOSE 52.6.0 

This runs the appropriate diagnostic for the device at physical 
address 52.6.0. 

•CSTM> EXERCISE 52.6.0 TIME 5 

This command exercises the device at physical device 52.6.0 for a 
period of 5 minutes. 



Diagnostics and Support Tape 3-15 



Support Tape 

The Support Tape allows diagnosis and repair of operating systems 
and hardware that cannot be booted from the system disk. The 
Support Tape runs on minimal hardware, with or without the system 
disk. 

The Support Tape is intended to: 

■ Provide a vehicle for distributing ISL-based support tools 

■ Host the on-line diagnostics subsystem environment (DUI) 

■ Provide a means to recover an unbootable HP-UX operating system 
on HP 9000 Series 800 computer systems. 

HP-UX Off-line Diagnostics and Utilities 

Running Off-line Diagnostics and Utilities from Support Tape 

• To run lOMAP from reset or transfer of control 

Boot -fron prir-i-ary boot p.ath d' or H>?> n 

Boot from alternate path Ct" or N>?> n 

Enter boot path or ?> 4.2.3 (physical address of 

Support Services Media deuice) 

Boot ing 

C o n s o 1 e 1 D e p e n d e n t C o d e \ 1 D C ) r e u i s i o n 4 
B o o t 1 D e p e n d e n t C o d e ( 1 D C !■■ r e u i s i o n 4 

Interact with I PL i'i or H>?> y 

Hard Booted 

ISL Revision fl.00.Hi2 June 22, 19S9 
ISL> lOMRP 

Note ^ complete listing of off-line diagnostics and utilities 

follows. 



. 
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Available Off-line Diagnostics and Utilities 

• Diagnostics and utilities available from Support Tape's ISL prompt 



Name 


HP Mode Number 


Description 


SS_CONFIG 


AU HPPA SPUs 


Stable Store Config. Utility 


HPUX 


AU HPPA systems 


HP-UX Loader UtiUty 


lOMAP 


All HPPA systems 


Input/Output Map Utility 


RECOVERY 


AU HPPA systems 


Support Kernel Loader 


CLKUTIL 


AU HPPA SPUs 


Clock Utility 


BCDIAG 


AU CIO SPUs 


A1126A Bus Converter Diag. 


A1002AI 


825/832/834/835/842/845/852/635/645 


A1002A SPU I/O Diag. 


A1002AM 


825/834/835/845/635/645 


A1002A SPU Memory Diag. 


A1002AP 


825/832/834/835/845/635/645 


A1002A SPU Proc. Diag. 


AllOOAI 


850/855/860/870 


AllOOA SPU I/O Diag. 


AllOOAM 


850/855/860/870 


AllOOA SPU Memory Diag. 


AllOOAP 


850/855/860 


AllOOA SPU Proc. Diag. 


EDBC 


890 


Bus Converter Diag. 


EDPROC 


890 


SPU Diag. 


MPROC 


870 


Multiprocessor Diag. 


MULTIDIAG 


817/827/837/847/857/867/877 


SPU Proc/Mem/IO Diag. 


TDIAG 


887/897 


PCX-T Proc. Diag. 


UNIPROC 


842/852/865/870 


Single Processor Diag. 
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Booting the HP-UX Support Tape 

• To run the Support Tape's operating system from reset or transfer of 
control 

Boot from primary boot path <Y or N>?> n 

Boot fror-i alternate path <Y or H>?> n 

Enter boot path or ?> 4.2.3 (physical address- of 

Support Seruices Media deuice) 

Boot ing 

Console 10 Dependent Code <IODC> revision 4 
Boot 10 Dependent Code (lODO revision 4 

Interact with I PL <Y or N>?> y 

Hard Booted 

ISL Revision fl.00.02 June 22, 1989 
ISL> hpux O: RECOVERY 

Not6 Booting the Support Tape operating system may 

take SEVERAL minutes. 



4 
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Support Tape Main Menu 

■ To get the Support Tape Main Menu from the HP-UX shell type: 

# menu 

■ Main Menu Screen: 

•j'_irrur-.i ihrc iinin iiLmu 

s. Search for a file 

b . Fleboot- 

1. Load a file 

d . On- 1 i ne D i agnost i cs 

r-i . D i s p 1 a y N a n u a 1 p a g e f o r a s p e c i f i c c o n r-i a n d 

r. Recover an unboo table HP-U!::! iyster-i 

u. Utilities 

X. Exit to shell 

This nenu is for listing and loading the tools 
contained on the support tape. Once a tool is 
loaded, it niay be run fror-i the shell. 

■i e 1 e c t o n e o f t h e a b o ■•.•' e • 
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Loading a File from Support Tape 

■ To load a file from the Support Tape Main Menu use the / option, 
as shown below: 

SUPPORT TRPE MfllH riEHU 

s. Search for a file 

b. Reboot 

1. Load a file 

d . On- 1 i ne D i agnost i cs 

Pi . D i s p 1 a y M a n u a 1 p a 9 e f o r a s p e c i f i c c o m r-i a n d 

r. Recouer an unboo table HP-UX system 

u. Utilities 

X. Exit to shell 

This r-'ienu is for listing and loading the tools 
contained on the support tape. Once a tool is 
loaded? it may be run from the shell. 

Jiielect one of the above! 1 

Fi lesystem kbytes used avail capacity Mounted on 
xdevxfs 2464 1937 527 79^^ 

Enter the name of the files that you want to load 
separated by spaces: newfs disk tab 



Once the file(s) has been loaded, exit to the shell for use. 
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Support Tape Utilities IVIenu 

■ If you select u from the SUPPORT TAPE MAIN MENU, the 
following menu will be displayed: 

SUPPORT TAPE UTILITIES MENU 

p. Try to resynchronize position on tapi 

t. Table of contents of a tape section 

r. Return to previous Menu 

X. Exit to the shell 

y e 1 e c t o n e o f t h e a b o u e • _ 

Support Tape On-iine Diagnostics l\/lenu 

■ If you select d from the SUPPORT TAPE MAIN MENU, the 
following menu will be displayed: 

ON LINE DIflGHOSTICS MENU 



0. CSSeDIRG 

1. FLEyDIflG 

2. SCSI DISK 

3. DTDUTIL 



esse disks 
FLEX disks 
SCSI disks 
Disk -Tape-Disk UTILity 



r. Return preyious nenu 
::■:;. Break to the shell 

Select o n e o f t h e a b o '■.' e ■ 
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HPUX Recovery - Main Menu 

Support Tape HP-UX Recovery Main Menu 

■ If you select r from the SUPPORT TAPE MAIN MENU, the 
following menu will be displayed: 

HP-UV RECOVERY MR IN MENU 

S e 1 e c t o n e o f t h e f o 1 1 o w i n g s 

a. Rebuild the boot lit (e.g.? ISL> and 
install all 'critical' files required 
to boot HP-UX on a customer's root file 
system. 

b. Do not rebuild the boot 1 if (e.g.? ISL> but 
i nst all ' cr i t i ca 1 ' f i 1 es requ i red t o boot 
HP- U >■, o n a c u s t o m e r ' s r o o t file s y s t e m . 

c . Rebu i 1 d on 1 y t he boot 1 i f (e.g.? 1 SL ) . 

m. Return to the 'Support Tape Main Menu'. 
X. Exit to shell 

Use this menu to select the leuel of reco'-.^ery 
desired. 

':> e 1 e c t i o n ° 
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PA-RISC System Exerciser (SX) 

System Exerciser (SX) is a suite of system exercisers designed to stress 
test PA RISC systems to isolate intermittent failures. SX can stress 
any or all of the following subsystems for a specified number of passes 
or length of time: 

■ CPU 

■ Memory 

■ Disks 

■ Network 

^A' is a separate diagnostic product which is available to HP support 
personnel only. 
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Running SX 

■ SX in invoked by running SX . 

*SX 



-^-^-■^-•^-■+^-H-H-^-^-^-H--^-^--^--i--l--^--l--i--^--^--i--^--^--^-•+•-^--l--i--i--i--^-•+•■-^--i-■+•■-!--!--l-- 



PR— RISC S'-istep'i Exerciser 



(ij;! Copyright Hewlett-Packard Co. ■+■■+■**** 
Rll RiQhts Reserved ****** 



****** This program may only be used by HP ****** 
****** support personnel and those customers ****** 
****** with the appropriate Class license or ****** 
****** Node license for systems specified by ****** 
****** the license. HP shall not be liable ****** 
****** for any dar-'iages resulting from misuse ****** 
****** or unauthorized use of this program. ****** 
****** This program remains the property of ****** 
****** HP. ****** 

****** ****** 

****** Version! B.01.07 ****** 

****** ****** 

*************************************************** 

Processing sxparm ........... = = ....,.... 

S y s t e m p r o b 1 e m s s o m e t i m e s ca u s e d a +• a c o r r u p t. i o n ? 

may accentuate these problems. Therefore? it is 
r e c o m m e n d e d t h a t p r e c a u +• i o n s b e t a k e n t. c^ p r o t. e c t. +■ h e 
integrity of customer data before using this or any 
diagnostic tool. 

Lock is: 739503 
Enter ke'-iS 
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Help 

To get help if you are in the System Exerciser, press the Help Key 
(F7). The help section is context-sensitive, so you will be shown 
information relating to the current System Exerciser screen. 

To explore the on-line help section, use the cursor movement keys 
(Arrow keys. Home key, Page Up, and Page Down keys). 
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HPUX 8.0 Diskless Clusters 

Creating a Diskless Cluster 

To create a cluster server and add clients, perform the following: 

Note Diskless clusters are NOT supported on HP-UX 

version 9.0. 
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1. Use the System Administration Manager program "Create an 
HP-UX Cluster." This will '"clusterize" a standalone system 
making it a cluster server. 

Note During this step, you may add clients that are of the 

same type (S300 or S800) as your server. 
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2. Where a Series 800 machine is to act as a server for Series 3XX 
clients, run /etc/update to update the server, and load Series 3XX 
software. 

3. Use the System Administration Manager program "Add Cluster 
Clients." 
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Diskless Basics 











Cluster Client 




Disk 




Cluster Server 




/ 




1 














Prin 


ter 


Auxiliary File/Swap Loca 




Server, or Swap 
Diskless Client or no 












\ 


Cluster Client 


\ 





























(optional) 



(optional) 



LAN Connection' 



Servers: Series 600 and 800 (except Models 808 and 815) can 

serve all types of clients. Series 3XX and 4XX can only 
serve 3/4XX machines. 

Clients: Series 800 Models 815, 822, 832, 842, 852, Series 3XX, 

and 4XX. No Series 800 machine may be served by a 
Series 3XX or 4XX machine. 
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Newly Clusterized Server 



Series 825/835/85X Cluster Server 



{partial hierarchy) 



! / ! 



|hp-ux+| -«- Context DeiwtKtent— I blm- 
File Paths i 



/ 



<Jocalroo)> 

NOTE: No Ssriss 3XX Software 
Is Installed. This will be 
added running by Vetc/update'. 

Hostname: bashful 

Internet Protocol Address: 192.6.1.1 

Station Address: 080009017134 



HP-MC68020 HP-PA 



Series 815 Client 



Series 350 Client 



# getcontext 

bashful HP-PA localroot default 

UNXA0721 



LAN connection 



After Updating HP-UX Series 3XX Software 



Series 825/835/85X Cluster Server 



(partial hierarchy) 



jTpjix+j— Context Dependent — - | bin+ | 
File Paths I 



<l!ashfu 



'stand alone~; 



'localroof , 



HP-MC68020 HP-PA 



HP 9000 Series 3XX software 
has now been Installed In CDF 
paths 

Hostname: bashful 

Internet Protocol Address: 192.6.11 

Station Address: 080009017134 



<3> 



# getconte.xt 

bashful HP-PA localroof default 

UNXA072S 



Series 815 Client 



Series 350 Client 



LAN connection 
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New Cluster Clients Added 



Series 825/835/85X Cluster Server 



(parlial hierarchy) 







I hp-ux+ ]-— Context Dependent — »| bin+ 
: , File Paths 




■^ocairooi.^ 

Hostname: bashful 

Internet Protocol Address: 192.6.1.1 

Station Address: 080009017134 



Series 815 Ciient (lanic m slots s and io) 



ISL> primpath 40.0.0.0.2S5 

ISL> autoboot on V^ 4 times hahest 

, I . slot number in ps 

Hostname: grumoy 

Internet Protocol Address: 192.6.1.2 

Station Address: 0600090A!=e24 



# getcontext 

grjmpy HP-PA remoteroot default 

Series 350 Client lanic m select code 211 



LAN connection ' 



To Boot: 


LAN. 21, bashful 


Choose SYSHPU'. 


1H SYSHPUX 
1D SYS DEBUG 




1B SYSBCh.UF 


Hostname: doc 




Internet Protocol Address: 192.6.1.3 | 


Station Address: 06 


.0009023485 



# getcontext 

doc remoteroot HP-MC68020 HP-fv1C68010 default 

1t/89 
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SAM—Create a Cluster 
Cluster Configuration 



SAM 



Cluster Contiauration 



Highlight an item and then press 'Return' or 'Select Item' 



Add Cluster Clients . . . 
Remove Cluster Clients . . . 
Designate Swap Location . 
ICreate an HP-UX Cluster 



\ 



Help 




Main 
Meru 




Shell 



Select I 
Task 



nan 



Figure 4-1. SAM: Cluster Configuration 
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Create an HP-UX Cluster 



SAM 



Create an HP-UX Cluster 



Fill in or modify the fields for the Cluster Server. Ootionally fill in 
fields for one or more Cluster Clients and then press 'Perform Task'. 



A system should not be converted to be a cluster server unless it is 
currently running in single user state. If this system is not in single 
user state fhen do not continue, exit 5AM and use 'shutdowndM)' to get it 
into the single user state. Once the system is in single user state, use 
SAM to convert the system to a cluster server. 

Is the system in single user state (y or n)? y ^ 



□□□□ nnnn 
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Fill in or modify the fields for the Cluster Server. Optionally fill in 
fields for one or more Cluster Clients and then press 'Perform Task' 



Node Name Internet Address Link Level Address Machine # of CSPs 



Server: 
Clients: 



Several networking and cluster capabilities 
require that a system name be set. Enter 
the desired name for this system and oress 
■Return" or 'Done'. 

Hostname: b»»hful •« 



H □□□Q 
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Create an HP-UX Cluster, Cont. 



Create an Hh-UX Cluster 



Fill in Of modify the fields for the Cluster Server. Optionally fill in 
fields for one or more Cluster Clients and then press 'Perform Task'. 

Node Name Internet Address Link Level Address Machine * of CSPs 



Checking to see if this system can be converted to a cluster server. This 
consists of checking for the existence of key commands used to create the 
cluster or used to boot the resulting cluster server. In addition, the 
files '/system/* /CDFinfo' are processed to determine what CDFs will need to 
be created. These checks will take about a minute or so. 



. I — working — | 

VpnncTunnn 

I iMVAOTr;*^ — 
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SAM 



Create an HP-UX Cluster 



Fill in or modify the fields for the Cluster Server. Optionally fill in 
fields for one or more Cluster Clients and then press 'Perform Task'. 

Node Name Internet Address Link Level Address Machine # of CSPs 



Getting information about this system. 



working ■ 



UNXA07t!*" ^^-^""^ 1V89 
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Create an HP-UX Cluster, Cont. 



SAM 



reate an MP-UX Cluster 



Fill in or modify the fields for the Cluster Server. Optionally fill in 
fields for one or more Cluster Clients and then press 'Perform Task". 

Node Name Internet Address Link Level Address Machine # of CSPs 



Server: 
Clients: 



bashful 



19Z6.1.1 



0>, 080009017134 s800 



Mam 
Menu 



□ □□ED 
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ISAM 



Create an HP-UX Cluster 



Fill in or modify the fields for the Cluster Server. Optionally fill in 
fields for one or more Cluster Clients and then press 'Perform Task', 



There is no automated way to undo this process once it has been completed 
(i.e.. there is no function in SAM to convert a cluster back to a 
standalone system). You should be sure that you really want to make this 
system a cluster server before proceeding. 

The last step in this process is to reboot the system, so you should be 

sure that you are ready to have the system rebooted when this process completes 

Do you wish to continue? (y or n) y '^ 



□□□□ □□□□ 
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Create an HP-UX Cluster, Cont. 



( 



Fiii in or modify the fields for the Cluster Server. Optionally fill in 
helds for one or more Cluster Clients and then press "Perform Task' 



WARNING: Before installing or updating applications on to your cluster, see 
the file ■/etc/newconfiq/Update_info/applic.instal!". There is a special 
set of tools and documentation for installina/updatmg applications on to 
mixed clusters available from Hewlett Packard. Information about when 
these tools are needed and how to obtain them is provided in this file. 
These tools are NC" needed to create a cluster, though you may want to re 
this information before proceeding. 



Do you want to continue with the creation of a mived cluster'' 



■n) y ^ 



□ □□□ □□□□ 
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SAM 



reate an HP-UX Cluster 



Fill in or modify the fields for the Cluster Server. Optionally fill in 
fields for one or more Cluster Clients and then press "Perform Task' 




□□□□ □□□□ 
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Create an HP-UX Cluster, Cont. 



Create an HP-UX Cluster 



Fill in or modify the fields for the Cluster Server. ODtionally fill in 
fields for one or more Cluster Clients and then press 'Perform Task" 



Creating cdfs, this will take 15 - 20 minutes for the server plus a few minutes 
for each cnode beina added. 



□□□□ □□□□ 
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Create an HP-UX Cluster 



Fill in 
fields 



Server: 
Clients: 



or modify the fields for the Cluster Server. Optionally fill in 
for one or more Cluster Clients and then press 'Perform Task'. 

Node Name Internet Address Link Level Address Machine 

bashf 



Task completed. 

The cluster has been created. See the file 
■'tmp.'clus'er.iog' for information about 
what has been changed on your system. 
There may also be information about minor 
problems that you should be aware of. 

— Press the space bar to continue — 



s800 



Ox 



□□□□ nnnn 
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Create an HP-UX Cluster, Cont. 



eate ; 



Fiil in or modify the fields for the Cluster Server. Optionally fill in 
fields for one or more Cluster Clients and then press 'Perform Task'. 

Node Name Internet Address Link Level Address Machine # of CSPs 



Under most circumstances the system should be rebooted no*. However, you 
have the choice of SAM booting the system for you (right now) or doing the 
reboot yourself. 



you want the ' 



to be rebooted ( 



i)'' y < 



□ □□□ □□□□ 
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Update 
Main Menu 



UPDATE 



Highlight a^ item and then press "Return" or "Select Item". 
To refresh the screen press CNTL-L 



Source: Tape Device 
/dev/rmt/Om 



Destination : Local System 
/ 



[Change Source or Destination -> I 

Select All Filesets on the Source Media -> 
Select Only Filesets Currently on your System -> 
Select/Viev/ Partitions and Filesets... 

How to Use Update 



HnHS □□□ 
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UPDATE 



Highlight an item and then press "Return" or "Select Item". 

To refresh the screen, press CTRL-L 



Source: Tape Device 
/dev/rmt/Om 



Destination: Local System 



Change Source or Destination 



Highlight an item and then press "Return" 
or "Select Item". 



Update from source tc destination: 



From Tape Device tc Lot 



Chance Source or Destination -> 



Hnns □□□a 
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From Tape Device to Local System 



Highlight 
To reTr 



From Ta 



1 



Fforri Tape Device to Local System 



Modify the desired and press "Done". 

Tape Device Fiie iSource): Acl»vA'ette3d<«2 ■« 

Destination Directory: [ 



How to Use Update 



HnnH □□□E 
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Main Menu 



Highlight an item and then press 'Return' or 'Select Item' 
To refresh the screen press CNTL-L. 



Source: Tape Device 
/dev/rct/c3dOs2 



Destination : Local System 



Change Source or Destination -> 

I Select Ail filesets on the Source Media -> 

Select Only Filesets Currently on your System -> 
Select/View Partitions and Filesets,.. 



How to Use Update 



HnHH □□□[! 



Update! 
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Select all Filesets on the Source Media 



i UPDATE 



Select All Filesets on the Source Media 



Highligh 
To refre 



Highlight an item and then press 

You have chosen to update your 
filesets from the source: /dev/r' 
onto destination: 

This update might take several h 
Would you like to: 


'Peturn 

system 
t/c3dOs 

ours to 


or 'Select ItemV 
by loading all of the 

complete. 


[start Loading Now . . 






Z]- 


Modify/View Partitions 
Return to Mam Menu 


and Filesets . 





How to Use Update 



Help 



Selec 
Item 



n □ 



Itxit 
Update 
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SAM— Cluster Clients 
Cluster Configuration 



/ 



SAM 



Cluster Configuration 



Highlight an item and then press 'Return' or 'Select Item' 



J \ 



lAdd Cluster Clients . . . 
Remove Cluster Clients . . 
Designate Swap Location . 



Create an HP- 



Help 




Main 
Menu 



T 
oelect 
TasK 



□ □□ 



SAM: Cluster Configuration 
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Add Cluster Clients 



-'^ ^N^ 


SAM Add Clust 


er Client? 


l\ 


Fill in the fields and th 
Client Name Internet Addres 
grumpv 192.6.1.2 


;n press "Perform Tasl- 

s Link Level Address 

0>:08O0O'3OAF8'?4 

Ov A 


Macfiine 
s800 




A 


▲ 




Ca 




Ox 




Ov 




Ox 






Ox 
Ox 
Ox 
Ox 












Ox 








Help 


Mam 
Menu 


Shell 


Perform 
Task 


Task / 


> 




_^ 
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.Add Cluiter Client; 

Fill in the fields and then press 'Perform Tasl-". 
Client Name Internet Address Link Level Address Machine 
grumpy 192.6.1.2 0v0800090AF824 s800 



A 


valid template file mu 


•,t be 


supplied tor 


ea 


z^-- S600 node, ^hes 


efite 


s mus' e«;^t ir- 


/e 


c'conf'gen. 






En 


ter the file name and 


then 


press 'Return' 


c: 


"Cone" 






Name of the template f 


ie: ^ 


leiS.dsKiess 





□ □H □□□£ 
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Add Cluster Clients, Cont. 



SAM 



Add Cluster Clients 



Fill in the fields and then press "Pertorm Task", 
iient Name Internet Address Link Level Address Machine 
grumpy !92.6.i.2 Ox 0500030AF824 ioOO 



192.6.1.3 



0x080009023485 



s300 



Mam 
Menu 



□ □□ED 
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Add Cluster Clients 



Fill in the fields and then press "Perform Task". 
Client Name Internet Address Link Level Address Machine 
grumpy 192.6.1.2 Ox 0800090AF824 s800 



doc 



192.6.1.3 



0x080009023485 s300 



SAM will modify your system to add the indicated client(s). This will take 
about three to five minutes per client. 

Do you wish to continue? (y or n> y ^ 



□□□□ □□□□ 
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Add Cluster Clients, Cont. 



the fields and then pres; "Ferfcrrr! Task', 



Creating Kernels for clients. This will take several minutes cer -eries 
800 client 'Senes 300 clients use default kernels shipped *ith the sy 
so it on^' takes only seconds tor each 300 client). 



□ 



□ 
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idd Clusfer Clients 



Fill in the fields and then press 'Pertorm Task" 



Creating client-spec if;: elements in cdf's. This w'll take a fe*' minutes 
per client. 



□□□□unnn 
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Add Cluster Clients, Cont. 



Add Cluster Client? 



Fill in the fields and then press 'Perfarrrt Task", 

Client Name Internet Address Link Level Address Machir 

grumpy 192.6.1.2 Ox Oe00u9OAFb24 soOC 



doc 



Task completed. 

The clients have been added to the 
cluster. See the file '/tmp/cluster.log' 
for information about vtfhat has changed 
on your system. There may also be 
information about minor problems that 
you should be aware of. 

— Press the space bar to continue. - 



nana □□ 
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SAM— Auxiliary File and Swap Server Configuration 
Peripherals Devices 



rip'te^a! L'e^1ce■^ 



hnht jr ''am jnr) frc rr = ''~ 

"Tinter? and PioUe'S -> 



Warning, vou are evecutma S-^M on a clustered S'ysten^. Vou 
ma/ only manipulate those peripheral devices that are pnvsicai'' 
connected to tms system. 

— Cress '^■■•= spa^e r.a- 'o continue -- 



meip 


Wain 


>he;! 


-eiect 
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•iters ana Plotter' 



i^ad a I erminai or Modetr 
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Disk and Swap Configuration 



uisK and i-wap Lonfiauration 



Highlight an item and then press "Return" or "Select Iten 
Disk Configuration: 

Add a Hard Disk Drive . . . 



You are running on a node in a cluster. Note that you may only 
manipulate disks which are physicaiiy connected to this node. 



Press the space bar to continue ■ 



'opace iiitorinauof 



Help 


Mam 
Menu 


Shell 


Select 
Item 



Previous 
Menu 
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Disk and Swap Configuration 

Highlight an item and then press "Return" or "Select Iten 
Disk Configuration: 

I Add a Hard Disk Drive .7~| M 
Remove a Hard Disk Drive . . . 
Change a Hard Disk Drive Address . . . 
Swap Configuration: 

Add Device Swap . . . 
Modify Device Swap . . . 
Add File System Swap . . . 
Status Information: 

View File System Information 
View Disk Space information 



Help 


Mam 
Menu 


Shell 


Select 
item 



Previous 
Menu 
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Add a Hard Disk Drive 



DiSi< arive or node! :..eiec* Code Ejs Aadre?; 



Mounuena 



The following disks are new to your system and may now be 
addea, Move tne :'j'So' 'o 'ne d^s- you *is^ 'o add, and 
press "Done". 



Model 



.elect bu? 

loae Add'es 



M[M]nn[ 
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^ac 3 "ara I'lSi- LJ-'ve 

: ir 0' 'rod'*, 'he desred 'lela; ana *hen ere 

Disl- drive or model Selec* Coae 

hp793" " 

uodge iiTiar, one o- O'.*;. 'A.'r, a'' '■,.,. . ■ ' ■= itoiagt 
Mount/enable »«h6n? imdrt as ges^red; . - . ■• no/< 



Mount directory 



ss -Pe 


tor 


m ^ 


'as 


Bus Agd 


rec 








ap 


5C 




or 


C-o 





-e:c 


Menu 




P*r<orm 


::i'_ 
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Add a Hard Disk Drive, Cont. 



/ 



Aoa d nara l'isk unve 



i!! in or modify the desired fields and then press "Perform Task' 
Disk drive or model Select Code Bus Address 
hD7937 7 Q 











Fill in or modify the desired 


•lelds and then press "Done". 




Initialize disk? (y or n) n 






Disk space allocation: 80 


M for swap, 465 M tor file system 

(use arrow keys to see more choices) 
1 









View/Modify Additional default file system options ? iy or ni n 



rlogin 



Disk 
Info 



File Sys 
Info 



■■7*ik 



File Sy; 
Info 



Exit 
Task 
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Add a Hard Disk Drive 

Fill in or modify the desired fields and then press "Perform Task". 

Disk drive or model Select Code Bus Address 

hp7937 7 

Usage (mark one or both with an "x") .... " file storage x swap space 

Mount/enable when? (mark as desired) . . . x now x on boot 

If usage includes file storage, fill m the fields below. 

Mount directory /auxfs 

Create a new file system? (y or n) . . y 

View/Modify additional default file system options ? (y or n) n 



Exit 
Task 
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Add a Hard Disk Drive, Cont. 



Fill in Of modify the aesired tiela; and then press "Pen 
D-sk d'ive 0- mode! Se^e:' Cede 5u; a 



Warning; if you proceed with Thi= tasr.. e^!Sf|rla ■nrormation 
wii| be destroyed, ire yo'^ sii'e yoj war-t *c ;cn*:rt;e: y '. 



Mount director; .''au-'r? 

Create a new file systern' ',v or n . , y 
View(K4odify additional default tile f>'=te" opt' 



Help Mam 



Shell Perforrri noa 
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Fill in or iTiodify the desired fields and then pres; "Perforr- Task" 
Disk drive o' mode* Select Code Bus Address 
hp/gs" " C 



It you continue with thi 


= task 


then you will be -equ 


-ed to regene-3-e 


■ 


1 your hernei and -eboct 


when 


you e'.if SAM. Tnis is 


,.'cur las; opco'tunit. 




, ''"^'' -^•- -■ -■■■■ 


ar-' 


:;---|... y r ' 









Moun' directory ■ 
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Add a Hard Disk Drive, Cont. 



Add a Hard L'lSk Drive 



Fill in or modify the desired fields and then press 'Perform Task". 
Disk drive or model xolo^t r^de Rue Arldrecc 



This node is not currently configured so that other nodes in the cluster 
can access its disK. To allow access to other nodes, you will nave to 
create a new kernel and reboot when you exit SAM. Do you want to go ahead 
and allow other nodes to access the disk? ( y or n) 



Create a new file system? (y or n) . . y 

View/Modify additional default file system options ? ty 



bhell Perform rlogin 
Task 



Disk 
Info 



File Sys Exit 
Info Task 



Usage imark one 
Mount/enable whe 



Disk added at /dev/dsk/OsO 
— Press the space bar to con 



swap space 

; on boot 



Mount directory /auxfs 

Create a new file system? (y or n) . . y 

View/Modify additional default file system options ^ (y or nl n 



riogir 
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Add a Hard Disk Drive 

Fill in or modify the desired fields and then press 'Perforni Task'. 
Disk drive or model Select Code Bus Address 
hp7937 7 
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Designate Swap Location 



y^ ~~~\ 


|SA. 




je---. 




A-ap Lcca-'C" 1 






in 0' Tiodi'y the aesired 

System Name 
hpcugsca \rco*> 
hDcugsta 

nptT,i 


leia 


; and then press "Pe'tor'n TaS'V 

Swap Lorat^or, 
npcugsco 
hpcjgsta mus noc^gsca 

npc'jgs.ca 



hpcugsta 




SAM: Designate Swap Location, Slide 1 Of 4 



sesianate 'jwap Locat'C 



in or modify tne desired fields and then press 'Pertom^ Tas 



Systen- l^jaiT-e 
hpcugscd iroot; 



W3P LOCdt'C 

hpcugscd 



All clients v.-hich have changed whe 
the changes wili taKe etrect. 



vap tc rriust be rebooted betcre 
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Designate Swap Location, Cont. 



Designate bwap Location 



the desired fields and then press 'Perlorm ' 



iystem isiame 
hpcugscd Iroot) 



swap Location 
hocuascd 



Swap locations successti.iiiy changed. ! he changes wi! 
the affected clients are rebooted. 

— Pre?? the space bar to continue. - 



not take ettect until 



riogin 
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System Administration IVIanager 



SAM 



System Administration Manager 



Highlight an item and then press 'Return' or 'Select Itert 



Users -> 
Group? -> 



Some of the changes made dunng this SAM session have altered the state of 
your system in such a way that it is essential that a new kernel is built 
and the system is rebooted before exiting SAM. 

Do you want to build a new kernel now? ( y or n) 



Task Customization . 
Other Utilities -> 



How to Use SAM 
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5 



DataPair/800 



Mirror Disk Basics 

■ A mirrored disk is a pair of disk sections that are copies of each 
other. To the user they look and act hke a single section. 

■ The pair is managed by kernel code called the mirror driver. A 
physical write is split into two write calls, one for each section of the 
pair. A physical read is routed to the least busy drive. 

■ Mirror disks are supported only on HP-FL drives on HP 9000 Series 
8XX machines (except 808 and 815). 

■ Section pairs must be on identical disk model numbers, and must 
have identical section numbers. Pair section internal structures 
(block size, fragment size, etc.) must be identical. 

■ The mirror driver allows a single HP 9000 Series 800 CPU to create 
and share up to 16 mirror disk pairs (32 drives). 

■ It is recommended (but not required) that each member of a pair 
be installed on separate HP-FL interfaces to prevent a single point 
interface failure from aiTecting both members of a pair. 
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Creating a Mirror Disk 

1. Create a new file system using the newfs command. For example: 
# newfs /dev/rdsk/c2003d0s7 hp7937 



LJ<2 



To 

> 

T3 











^1 
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2. Mirror the primary and secondary disk sections. For example: 

# mirror -c /dev/rdsk/c2002d0s7 online /dev/rdsk/c2003d0s7 
offline 




(/) a 
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3. Update the secondary disk section with an exact image of the 
primary disk section using the mirror command. For example: 

# mirror -r /d€v/dsk/c2002d0s7 



^ I ^ 
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/ttc/vairror 

■ The mirror command is used to configure, unconfigure, and control 
mirrored disks. The mirror command and options are shown below: 

i^ mirror -c f-f] primary dev pstate secondarydev sstate 

# mirror -n mirrordev . . . 

:j^ mirror -o [-f] -p\-s mirrordev [[-p\-s] mirrordev ... 7 

# mirror -r [-1] mirrordev 
a^ mirror -I [device] 

Where: 

Key Operation 

-c Configure a mirror disk (does not work for root 

and swap; uxgen required). 
-/ Manually set fail flag for the OFFLINE section 

(when set, indicates hardware failure), 
primarydev Block or character special file path of the 

primary disk section of the mirror, 
pstate State of primary disk section. Set pstate to 

online or offline (typically set to online). 
secondarydev Block or character special file path of the 

secondary disk section of the mirror. 
sstate State of secondary disk section. Set sstate to 

online or offline (typically set to online), 
-u Unconfigure the named mirror(s); revert 

mirrored section(s) to unmirrored. 
mirrordev Block or character special file path of primary 

disk section in mirror. 
-p\-s -p requests primary disk section go offline; -s 

requests secondary disk go offline, 
-r Reimage the named mirror (assures identical 

data on both sections of mirror). 
-/ Requests that a table-driven reimage (update 

only changed files since going offline). 
-/ List mirrors (uses /etc/mirrorlog daemon and 

/e / c/m irro rtab). 
device Special file path of desired mirror disk. 
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Listing Mirror Disic Status 

■ To list mirror status, type: 

# /etc /mirror -I 
m mirror -I displays one line per mirror in the following format: 
primarydev pstaie secondarydev sstate fail 
Where: 

Key Operation 

primarydev Block special file path of primary disk section. 
pstaie ONLINE — Disk section is available for reads 

and writes. 

OFFLINE — Disk section is not available for 

reads and writes. 

REIMAGE — Disk section is being re-imaged. 
secondarydev Block special file path of secondary disk section. 
sstate Same as pstate above except indicates 

secondary disk section state. 
fail FAIL — Hardware fail flag; set automatically on 

failure or by mirror -cf command. 

GOOD — Hardware status flag displayed if FAIL 

flag not set. 

■ Example: 

i^ /etc /mirror -I 

/dev/dsk/cOiOsi ONLINE /dev/dsk/cld0s4 OFFLINE GOOD 

/dtv/dsk/cOdOslO ONLINE /dev/dsk/cldOslO REIMAGE GOOD 
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Setting Mirror Disk Sections Offline 

■ Only one section of a mirror disk may be taken offline at a time; the 
other must remain onhne. 

■ Use the mirror -o command to take a section offline (see 
/etc/mirror command earher in this section). 

■ Example: 

^ /etc/mirror -I 

/dev/dsk/cOdOslO ONLINE /dev/dsk/cldOslO ONLINE GOOD 

# /tic /mirror -OS /dev/dsk/cOdOslO (set secondary OFFLINE) 
a^ /etc/mirror -I 

/dev/dsk/cOdOslO ONLINE /dev/dsk/cldOslO OFFLINE GOOD 

# /etc/mirror -r /dev/dsk/cOdOslO (reimage, set ONLINE) 

# /etc /mirror -/ 

/dev/dsk/cOdOslO ONLINE /dev/dsk/cldOslO ONLINE GOOD 

# /etc /mirror -op /dev/dsk/cOdOslO (set primary OFFLINE) 
i^ /etc/mirror -I 

/dev/dsk/cOdOslO OFFLINE /dev/dsk/cldOslO ONLINE GOOD 
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File Systems 



Series 600/800 Conventional Disk Sectioning 
Scheme 
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Figure 6-1. Disk Sectioning Scheme 



Note 



4 



Do not allocate file systems on sections that overlap. 
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Creating Conventional Series IHP-UX File 
Systems 

1. Initialize media using mediainii: 
# mediaimt /dev/diag/dsk/cldO 



NEW DIK ORfVE 




Figure 6-2. Initializing the Media 



2. Make a new file system using newfs: 
# newfs /d€v/rdsk/cld0s7 hp7937 



NEW DISC DRIVE 




Figure 6-3. Malting a New File System 
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3. Make a mount point directory using mkdir: 
# mkdtr /newdir 



SYSTEM DISC DRIVE 



Section 4 c0d0s4 / 



extra usr 



[m] M [^■■■[±\ newdir 



Section 14 c0d0s14 



Section 1u cOdOslO 



i ^ 1 ^ i I 



Section 3 cOdOs^ 



UNXA0503 11/89 

Figure 6-4. Adding a New Directory 
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4. Mount the new file system using mount: 
# mount /dev/dsk/cld0s7 /newdir 



SYSTEM use DfilVE 



Section4 cOdOM [T] 



NEW DISC DRIVE 



la] m\ [^■■■[*] I newdir | 



SectkHiMcOdOiM 



iiiiiii 



Section 10 oOdOdO 



iiiiiii 



Sectim 3 c(M0*3 



iiiiiii 




UNXA0504 1/89 

Figure 6-5. Mounting the New File System 
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Creating LVM File Systems 

1. Initialize the media using mediaimt: 
9^ mediaimt /dev/diag/dsk/cl dO 



NEW DISC DRIVE 




Figure 6-6. Initializing the Media 

2. Create a physical volume for use as a volume group: 
# pvcreate -f /dev/rdsk/cld0s2 



NEW LVM DISK 



P V R A 



BAD BLOCK POOL 



Physical Volume Reserved Area 
Contents: 

o id's for volume group and physical volumes 

o Physical extent size 

□ Physical volume size 

° Bad block directory 

a Size and location of other disk structures 



Transparent software sparing is not supported on HPIB 
or the root disk (only used if dish f"iardware sparing tails) 



Figure 6-7. Creating a Physical Volume 
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3. Make a directory under /dtv for the volume group: 
# mkdir /dev/vgOJ 



NEW LVM DISK 



P V R A 



BAD BLOCK POOL 



ROOT DISh 








T 


-1 


dev 


1 


1 vg01 1 



Figure 6-8. Creating a /dev SubdirectcM'y for the Volume Group 

4. Make a group device file with mknod: 
9^ mknod /dev/vgOl /group c 64 0x010000 



NEVv' LVM DISK 




ROOT D!S^ 







r- 






dev 












yQ(7-! 




fgroupj 



Figure 6-9. Creating a group Device File 
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5. Create a volume group: 

# vgcreate /dev/vgOl /dev/dsk/cld0s2 



P V R A 


V G R A 




BA[ 


) BLOCK P0( 


)L 



Volume Group Reserved Area Contents 

■ Volume Group Descriptor Area (VGDA) 

identifies iogicai and physical voiumes 



>gi 



Lti^Mi, iiidppinQ 



■ Volume Group Status Area (VGSA) 

Physical volume status {missing/present) 
Physical extent status (staie/oK) 

■ Mirror Consistency Record (MCR) 

Lists disk writes in progress 

'vgcreate' creates or updates '/etc/lvmtab' 

Adds volume group intormation to '/etc/ivmtab' 
Figure 6-10. Creating a Volume Group 

Create a 100Mb logical volume in volume group one: 
# Ivcreate -L 100 vgOl 



NEW LVM DISK 



ROOT DISK 



P V R A 


V G R A 




BAD BLOCK POOL 
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d 








dev 




etc 
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A 


vg®1 


\lvmtab 



CHARACTER 
DEVICE FILE 



Figure 6-11. Creating a Logical Volume 
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7. Create a physical file system for logical volume one: 
# newfs /dev/vgOl/rlvoll hp7937 



NEW LVM DISK 


P V R A 


\'' G R A 




1 


1 lost+found 1 






BAD BLOCK PCOL 



Figure 6-12. Creating a Physical File System 

8. Make a mount point directory using mkdir: 
# mkdir /newdir 

ROOT DISK 



NEW 


LVM DISK 




P V R A 


V G R A 










1 






ost+found 








BAD BLCCI- PC 


ZJ 




Figure 6-13. Creating a Mount Point Directory 
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9. Mount the new file system using mount: 
# mount /dev/vgOl/lvoU /newdir 



NEW LVMDISK 



r V n H 



V GR A 



j: 



lost+found 



BAD BLOCK POOL 



ROOT DISK 




Figure 6-14. Mounting the New LVM File System 
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/eic/ntw^s 

■ Creates a file system using default values from /tic/diskiah. 
m Calls mkfs to construct the file system: 

# /etc/newfs [-v] [mkfs- options] devicefile model 
Where : 

Key Operation 

-V Verbose mode. 

mkfs-opttons Any option available with mkfs; the options override 

the default values. 
devicefile Special device file associated with the device. 

model HP model number of the disk (see /etc/disktab). 

m Example (newfs with default values): 

# newfs /dev/rdsk/cldOsS hp7935 

■ Example (neivfs specifying file system characteristics; overrides 
/etc/disktab): 

# newfs -b 4096 -f 2048 -m 15 -i 4096 /dev/rdsk/cldOsS hp7935 
Where: 

Key Operation 

-b 4096 Specifies block size in bytes. 

-/ 2048 Specifies fragment size in bytes. 

-m 15 Specifies the minfree value in percent. 

-I 4096 Specifies one inode for every 4096 bytes of file space 

(default: one inode for every 2048 bytes of file space) 
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The /etc/disktab File 

■ disktah defines supported disk drive geometries and disk section 
characteristics. 

■ Used by /etc/newfs to create HP-UX file systems. 

■ Options entered with the newfs command override parameters 
contained in /etc/ disktah. 

■ For each supported HP model number, disktah lists: 

ty Type of disk (removable or Winchester). 

ns Number of sectors per track. 

nt Number of tracks per cylinder. 

nc Total number of cylinders on the disk. 

s[0-n] Section size in sectors; file system size = DEV.BSIZE * 

the number of sectors (where DEV_BSIZE = 1024 bytes). 

h[0-n] Section block sizes in bytes. 

f[0-n] Section fragment sizes in bytes. 

se Number of bytes per sector. 

rm Number of revolutions per minute. 
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Example (a sample entry for an HP7937 disk): 



hp7937:\ 



t\-winchester:ns#30:nt#13:nc#1396:rm#3600:\ 

sb#24280:b0#8192:f0#1024:\ 

sl#48560:bl#8192:fl#1024:\ 

s2#558051:b2#8192:f2#1024:\ 

s3#29298:b3#8192:f3#1024:\ 

s4#107426:b4#8192:f4#1024:\ 

s5#216664:b5#8192:f5#1024:\ 

s6#1998:b6#8192:f6#1024:\ 

s7#75152:b7#8192:f7#1024:\ 

s8#353778:b8#8192:f8#1024:\ 

s9#324196:b9#8192:f9#1024:\ 

sl0#129024:bl0#8192:fl0#1024:\ 

sn#482898:bll#8192:fll#1024:\ 

sl2#556052:bl2#8192:fl2#1024:\ 

sl3#507282:bl3#8192:fl3#1024:\ 

sl4#24280:bl4#8192:fl4#1024:\ 

sl5#48560:bl5#8192:fl5#1024:\ 



A Conventional File System /etc/checklist Example 

# cat /etc/checklist 
/dev/dsk/c0d0s4 / 
/dev/dsk/c0d0s3 /extra 
/dev/dsk/c0d0s5 /mnt 
/dev/dsk/cOdOsO /tmp 
/dev/dsk/cOdOslO/usr 
/dev/dsk/cOdOsl swap 

1 This column: Backup frequency, not implemented, set to 0. 

2 Root should be assigned a pass number value of 1 (fsck ignores file 
systems having a pass number value of 0) . 



hfs 


rw 


Qi 


l2 


# root 


hfs 


rvv 





2 


# extra 


hfs 


rw 





3 


# /mnt 


hfs 


rw 





4 


# /tmp 


hfs 


rw 





5 


#/usr 


ignore 


sw 








# swap 
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A Logical Volume Manager File System /etc/checklist 
Example 

# cat /etc/checklist 
/dev/vgOO/lvoU / 
/dev/vg00/lvol2 /swap 
/dev/vg00/lvoi3 /usr 
/dev/vgOl/lvoU /data 

1 This column: Backup frequency, not implemented, set to 0. 

2 Root should be assigned a pass nimiber vailue of 1 {fsck ignores file systems 
having a pass number value of 0) . 



hfs rw 


Qi 


12 


# root 


swap sw 
hfs rw 
hfs rw 








2 
3 


# primary swap 

# /usr 

# /data 
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/etc /mount 



The /etc/mount command announces to the system that a 
removable file system is to be attached to the file tree at directory. 

Executing mount with no parameters shows all file systems 
currently mounted by printing the table contained in /etc/mnttab. 

The command and command parameters are shown below: 

# /etc/mount -a 

# /etc/mount [fsname directory [-f] [-0 options] f-t type]] 

# /etc/mount [-p] [-1] [-L] [s] [-u] 



Where: 

Key 

-a 

fsname 
directory 

-f 

-0 options 



■P 

-t type 



Operation 

Attempt to mount all file systems listed in 

/etc/checklist . 

Full path name of block special device file associated 

with file system. 

Full path of existing directory where the file system is 

to be mounted. 

Force the file system to be mounted. 

Defaults — use options specified, or one or more of the 

following separated by commas: 

rw — Read/Write (default). 

ro — Read only. 

suid — Set user ID execution allowed (default). 

nosuid — Set user ID execution denied. 

Displays local mount information. 

Displays local mount information, plus cluster- wide 

A"jF5 mounts. 

7.0 treatment of /etc/mnttab file: does not add kernel 

mount information to /etc/mnttab. 

Print the list of mounted file systems in a format 

suitable for use in /etc/checklist. 

Specifies a file system type. Acceptable types are hfs. 

cdfs, and nfs. 
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/etc/umonni 

■ Detaches a file system from the HP-UX tree. 

■ File system must be quiescent. 

■ The root file system and the file systems used in conjunction with 
dynamic swapping cannot be unmounted. 

■ The command and common parameters are shown below: 

# /eic/umouni -a f-v] [s] [-h host] [-t type] 
H^ /etc/umount fsname \ mouni_point_dir 

Where: 

Key Operation 

-a Attempt to unmount all file systems listed in 

/etc/mnttab . 
fsname Full path name of special device file associated 

with the file system, or the full path name of 

the mount-point-directory associated with the 

file system to be unmounted. 
mount_point.dir Full path name of the system's 

mount-point-directory. 
-V Verbose. 

-s 7.0 treatment of /etc/mnttab file (does not add 

kernel mount information to /etc/mnttab. 
-h host Unmount only those file systems in /etc/mnttab 

that are remote- mounted from the host. 
-/ type Unmount only file systems mounted with a 

given type. 
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/usr/bin/bdf 



Prints the amount of free disk space available on the specified file 
system. 

bdf with no options prints information on all mounted file systems. 

The command and parameters are shown below: 

$ /usr/bin/bdf [-b] [-i] [-l\-L] [-i type \ [filesystem] \ file] . . . J 

Where: 



Key 

-b 



-i type 
filesystem 



file 



Operation 

Report on the file systems; include dynamic swap 

information. 

Report the number of used and free inodes. 

Report on the file systems of a given type (hfs or nfs). 

Special device file associated with file system (for 

example /dev/dsk/cOdOs4). 

Print information on the file system that contains file. 

Display disk-space-available information for a locally 

mounted file system. 

Display information for the file system that can be 

unmounted from the local cnode (includes file 

systems mounted on the local node and cluster-wide 

NFS mounts). 



Example {bdf -b prints the following information): 



Filesystem 


kbytes 


used 


avail 


capacity 


Mount 


/dev/dsk/c0d0s4 


102512 


26665 


65596 


29% 


/ 


/dev/dsk/cOslO 


123295 


42739 


68226 


39% 


/usr 


/dev/dsk/cOdOsO 


23168 


32 


20816 


0% 


/tmp 


/dev/dsk/c0d0s5 


207127 


15 


186399 


0% 


/mnt 


swapping 


4096 


2048 


2048 


50% 


/mnt 


/dev/dsk/c0d0s3 


27912 


26100 


1812 


102%,! 


/extra 



1 File system /exira is filled beyond MINFREE by 2%. 
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MINFREE Space vs. User File System Space 

■ File system performance rapidly decreases when the file system is 
filled beyond 90% of its total capacity. 

■ To prevent this performance degradation, HP-UX compares the 
actual file system fill to the file system's minimum allowed free space 
(MINFREE) value. When a file system's fill value leaves less than 
the MINFREE value, only a superuser can write on the remaining 
free file space. 

■ The default value of MINFREE is set by HP-UX to 10. MINFREE 
can be set by /etc/newfs when the file system is created, or altered 
using the /etc/iunefs command. For example: 



100% of file system space 
90% of file system space 




111% of regular user space 
100% of regular user space 

( as^epo'ted by 'bdf ) 



Figure 6-15. MINFREE Space vs. User File System Space 

To calculate user writable space in percent: 
% user_space = 100 - MINFREE 
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LIF Volume Header Contents 

a Eight blocks used for SwitchOver/UX 

□ Label information for LIF Volume 

LIF Volume Contents 

□ LIF Utilities/Files 

ISL •*— Initr^i System Loader 

hHPUX ^-loads HP-UX kernpl file 

AUTO ^^- contains the autoboot string 

LABEL -^-used by t^PUX to locate the root logical volume 

and duiing maintenance mode boot to configure 

root and primary swap 
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Causes of File System Corruption 

■ Improper shutdown procedures. 

n Not using shutdown or reboot to halt the CPU. 
n Physically write-protecting a mounted file system. 
n Taking a mounted file system ofi'-line. 

■ Improper startup procedures. 

□ Not checking a file system for inconsistencies. 

□ Not repairing inconsistencies found. 

■ Hardware failure. 

n Disk I/O subsystem failure. 



File System Checker 



/etc/fsck File System Checker 

■ fsck checks for file system corruption by comparing the customer 
file system to an internal fsck standard that defines how a high 
performance HP-UX file system should be constructed. 

If corruption is detected, fsck will attempt to repair the damage. 

■ fsck has two operating modes: 

preen Automatically corrects inconsistencies that will not 

result in data loss. 

interactive Prints a brief error message for each inconsistency and 
prompts the user for the corrective action. 
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/etc/fsck Syntax 



Caution f^ck should not be run on a mounted file systems 

• (except root which cannot be unmounted). Users 

must not access files while fsck is running so use 
shutdown before invokinp" fsck when running fsck 
online. 

fsck should be run on character device files. 

■ Preen Mode Run String: 

# fsck -p [device^file] 

# fsck -P [device^filej 

m Interactive Mode Run String: 

# fsck f-y] f-nj f-b block] f-qj [device^file] 
Where: 

Key Operation 

-p Check file system for inconsistencies. 

-P Check file system specified if not cleanly unmounted. 

-b block Use redundant superblock specified in block variable 

to check file system. Use when primary superblock is 

corrupted. 
-y Assume yes response to all fsck questions (use with 

caution). 
-n Assume no response to all fsck questions (do not 

write to file system). 
-q Fix counts in superblock and cylinder groups; print 

brief message. 
devtce_fil€ Device file of the file system to be checked (for 

example /dev/[r]dsk/cXdOsY or /dev/vgXX/rlvolY). 

If not specified, fsck runs on high performance 

systems in /etc /checklist. 
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Five Basic Steps to Repairing File Systems 

1. Run fsck in preen mode to repair simple file system errors. 

2. If file system inconsistencies still exist, run fsck in the interactive 
mode with the -n option. Redirect the output to a printer or file. 

3. Analyze the error printout or the file created in step 2 to determine 
the problem. 

4. Mount the file system (for example, # mount -f /dev/dsk/cOdOslO 
/mount_potnt_dir) and copy the files to be removed by fsck to a 
clean file system. 

5. Invoke fsck interactively and repair the damage. 



Logical Volume Manager Basics 

■ Using LVM, you can combine one or more disks (physical volumes) 
into a volume group, which can then be subdivided into one or more 
logical volumes. 

■ LVM is not a file system. It is a manager that points to the start 
and end of logical volume data space for each physical disk that the 
logical volume happens to span. 

■ Logical volumes resemble disk sections, but with some important 
differences: 

a Logical volumes can range in size from 1 MB to 4 GB. 

Maximum size: File system 4 GB. Root 2 GB. Raw file system 
data 2 GB 
a Logical volumes can be expanded or reduced in size as needs 
change. 

Warning Reducing a logical volume's size will result in 

edata loss. Always back up logical volume data 
before reducing logical volume size. 
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LVM Spans Disks 

■ File systems can be larger than a physical disk's size. 

■ Logical volumes can grow and shrink allowing more efficient space 
usage. Volume Group 



)lume Group 




Physical Volumes 




Logical Volumes 



Figure 6-20. LVM Spanning Disks 
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LVM's Logical to Physical Extent Mapping 



Volume broup 

Physical Volume* Logical Volume 1 



; Physical Extent- 
CPE) 



PE size = LE size 

LVM058 




4 ME 



4 ME 



4 MB 



■ Logical Extent 
O-E) 



Logical Volume 2 



4 MB 



4 MB 



Loaical Extent 



Figure 6-21. LVM Logical to Physical Extent Mapping 

Extent size must be a power of 2 (range: 1 - 256 MB). Set by 
vgcreate -s 
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Displaying LVM Information 

■ For Physical Volumes 

# pvdisplay [-v] /dev/dsk/c*d0s2 (displays all physical disks 
searching for LVM physical volume information) 

■ For Volume Groups 

# vgdisplay [-v] /dev/vg* (displays information on all volume 
groups) 

■ For Logical Volumes 

# Ivdisplay [-v] /dev/vg* /Ivol* (displays all logical volumes in all 
volume groups) 

■ To display kernel devices on LVM Bootable Disks 

# Ivlnboot -V (displays root, primary swap, and dump logical 
volumes) 

■ For Swap Information (all swap including LVM) 
9^ swaptnfo 

m The contents of /etc/lvmtab 

# strings /etc/lvmtab (displays volume group/physical volume 
relationships) 
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Logical Volume Manager Rules 

1. A disk drive must be dedicated exclusively to the LVM. 
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2. A disk drive can be a member of only one volume group. 
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3. HPIB interfaced drives must not be mixed with HPFL or SCSI 
drives. HPIB disks must reside in their own exclusive volume 
group(s). 
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4. The maximum number of logical volumes in a volume group is 
255. (Range is 1 - 255; Default is 255; Kernel tunable parameter: 
maxlvs) 

5. The maximum number of physical extents allowed per physical 
volume is 65,535. (Range is 1 - 65,535; Default is 1016; Kernel 
tunable parameter: maxpxs) 

6. Maximum number of physical volumes per volume group is 
255. (Range is 1 - 255; Default is 16; Kernel tunable parameter: 
maxpvs) 
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7. More than half of the configured LVM disks in a volume group 
must be present to change or activate that volume group. Quorum 
is checked both during configuration changes (for example, when 
creating a logical volume) and at state changes (for example, if a 
disk fails). If quorum is not maintained, LVM will not acknowledge 
the change. To override quorum check use vgchange with the -q 
option. If quorum is not met on the root volume group, the system 
will not boot. This makes it wise to override quorum on root using 
vgchange -q n. If this change is not made and quorum is not met, 
use ISL > hpux -Iq to boot. 
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8. Any time a change is made to the root volume group (i.e., root, 
swap, dump, or file system) Boot Data Reserved Area (BDRA) 
must be updated (see the Ivlnboof for details on accomplishing this 
task). Failure to do this may result in an unbootable system. 
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LVM Device Files 

■ The /etc/lssf command does NOT list LVM special files. Use //. 

■ Physical volume 
/dev/[r]dsk/cXd0s2 



Key 

[r] 
X 



Operation 

If present, indicates character (raw) access 
Integer logical unit (lu) number 



Volume Group 
/d e v/vgXX/g roup 



Key 

XX 
group 



Operation 

Integer volume group number (0 
Must be called group 



255) 



Logical Volume 

/d e v/vgXX/[r]lv o I Y 



Key 

XX 

[r] 
Y 



Operation 

Integer volume group number (0 . . . 255) 
If present, indicates character (raw) access 
Integer logical volume number (1 . . . 255) 



Example: 

# U /dev/vg02 
crw-rw-rw- 

brw-r 

crw-r 



1 root root 64 0x020000 Sep 21 10:59 group 
1 root root 64 0x020001 Sep 21 10:59 IvoU 
1 root root 64 0x020001 Sep 21 10:59 rlvoU 



Key 

64 
02 

0000 
01 



Operation 

Major number always 64 
HEXADECIMAL volume group number 
Always zeroes for group 
HEXADECIMAL logical volume number 
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LVM Physical Volume Commands 

pvcreate Makes a disk an LVM disk (a physical volume). 

pvdtsplay Displays information about physical volumes in a 

volume group. 

pvchange Sets physical volume characteristics to allow or deny 

allocation of additional physical extents on this disk. 

extendfs Extends the size of a logical volume at the physical 

volume level. 

pvmove Moves allocated physical extents from source to 

destination within a volume group. 



LVM Volume Group Commands 

vgcreate Creates a volume group. 

vgdisplay Displays information about volume groups. 

vgchange Activates or deactivates one or more volume groups. 

Allows a volume group to mount with or without a 
quorum. 

vgexiend Extends a volume group by adding disks to it. 

vgreduce Reduces a volume group by removing one or more 

disks from it. 

vgscan Scans all disks and looks for logical volume groups. 

vgsync Synchronizes mirrors that are stale in one or more 

logical volumes. 

vgremove Removes definition(s) of volume group(s) from the 

system. 

vgexpori Removes a volume group from the system without 

modifying the information found on the physical 
volume(s). 
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vgimport Adds a volume group to the system by scanning 

physical volumes which have been exported using 
vgexpori . 



LVM Logical Volume Commands 

Ivcreate Creates a logical volume. 

Ivdisplay Displays information about logical volumes. 

Ivchange Changes characteristics of logical volume including 

availability, scheduling policy, permissions, block 
relocation policy, allocation policy, mirror cache 
availability. 

Ivextend Increases disk space allocated to a logical volume. 

Ivmerge Merges two logical volumes into one logical volume. 

Ivreduce Decreases disk space allocated to a logical volume. 

Ivremove Removes one or more logical volumes from a volume 

group. 

Ivsplit Splits a mirrored logical volume into two logical 

volumes. 

Ivsync Synchronizes mirrors that are stale in one or more 

logical volumes. 
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Creating Boot Disks in the Root Volume Group 

■ Creating a bootable disk is useful for two specific cases: 

Creating a mirror for the root logical volume. 

Creating a new root logical volume (moving root from one disk to 

another). 

■ Briefly, the steps to add a boot disk to the root volume group are: 

1. Use pvcreate -B when you make the disk a physical volume. 

2. Add the disk to a volume group w4th vgextend. 

3. Use mkbooi to place boot utilities (LIF) in the boot area. 

4. Use mkbooi -a to modify the AUTO file in the boot LIF area. 

Note Other procedures will apply. See System 

- Administration Tasks, Managing Logical Volumes, 

MK Chapter 8. 
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LVM Data Structures Backup 

■ Run vgcfgbackup periodically (at least once per day) and whenever a 
change is made to the LVM configuration including: 

Adding or removing disks to or from a volume group 
Changing boot disks in a volume group 
Creating or removing logical volumes 
Extending or reducing logical volumes 

Shown below is a LVM system that needs LVM data structure backup. 
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With all disks in the volume group online, run: 

# vgcfgbackup vgOl (backup placed in /etc/lvmconf/vgOl.conf) 

# vgcfgbackup vg02 (backup placed in /eic/lvmconf/vg02.conf) 

# vgcfgbackup vg03 (backup placed in /etc/lvmconf/vg03.conf) 



Warning 







vgcfgbackup does not back up user data! It only 
backs up LVM data structures. 
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LVM Data Structures Restore 

■ Use vgcfgrestore to restore LVM data structures after a disk 

hardware failure (one of many steps), or the result of improper use 
of HP-UX commands such as dd, mkfs, or newfs. 

m Shown below is the LVM system that needs LVM data structure 
restored: 
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Note 



User data is not restored by the vgcfgrestore 
command. 
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Make sure that all volume groups involved are made not available: 

9^ vgchange -an vgOl 
9^ vgchange -a n vg02 

Restore LVM data structures on all damaged physical volumes: 

# vgcfgrestore -n vgOl /dev/rdsk/cl d0s2 

# vgcfgrestore -n vg02 /dev/rdsk/c2d0s2 

Make all volume groups involved available: 

# vgchange -a y vgOl 

# vgchange -a y vg02 



Is /etc/lvmtab Blown? /etc/vgscan to the 
Rescue! 

■ The /etc/lvmtab file contains important LVM volume group 
information. If this file is missing or corrupted, vgscan can restore 
it based on LVM structures on the LVM disk drives and device file 
information. 

■ The three steps shown below will produce valid information in 
/etc/lvmtab. 

1. U /etc/lvmtab exists, rename it /etc/lvmtab. old with the mv 
command. 

2. Make sure all physical volumes are powered up and on-line. 

3. Run vgscan -v to create and update /etc/lvmtab . 
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Logical Volume Manager Commands 

/etc/extendfs 

■ If the original hfs filesystem created on logicaLvoLpath does not 
make use of all available space, extendfs can be used to increase the 
hfs filesystem size. The root ( / ) system cannot be extended. 

■ The exiendfs command and options are shown below: 
# extendfs [-q] [-v] [-s size] logicaLvoLpath 

Key Operation 

-q Query the size of char_dev^fHe. Do not extend 

the volume specified by logicaLvoLpath. 

-V Verbose. 

-5 size Integer number of 1024 byte blocks to add to 

hfs file system. If -s size is not specified, 
maximum possible size is used. 

logicaLvoLpath Character device file of disk to be extended. 

Example : /d e v/vgXX/rlvol Y 

To extend a generic file system: 

# umount /dev/vgXX/lvolY 

(filesystem must be unmounted before extendfs) 

# Ivexiend -L larger^size_in-MB /dev/vgXX/rlvolY 
if extendfs /dev/vgXXrlvolY 
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/etc/lvchange 

■ Changes the characteristics of a logical volume. Optional 
command-line options and parameters specify the type and extent of 
the change. All options take effect immediately. Before deactivating 
a logical volume, unmount the logical volume using umount before 
using Ivchange. 

■ The Ivchange command and non-mirror options are shown below: 

# Ivchange [-a availability] f-p permission] [-r relocate] [-C 
contiguous] Iv^path 

Key Operation 

-a availability Activate or deactivate the availability of a 
logical volume. Availability has two allowed 
values: y = logical number is available, n = 
logical volume is temporarily unavailable (all 
current processes using the logical volume will 
still have access). 

-p permissions Sets read/write permissions. Permissions has 
two allowed values: r = read-only, w = 
read/write. Default is read/write allowed. 

-r relocate Set bad block relocation, y = relocate blocks 

(default), n = do not allow bad block relocation. 

-C contiguous Set allocation policy, y = allocate extents in 
ascending order without gap, n = allocate 
extents where available. 

lv_path Path of logical volume. 

Example: /dev/vgXX/lvolY 
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/etc/lvcreafe 

m Creates a new logical volume within a volume group specified by 
voLgroup_nam€. If Iv^name is not specified, a system-generated 
name of the form IvolN is created, where N is the minor number of 
the new volume. Once a logical volume is created, it can be altered 
by Ivchange, Ivextend, and Ivreduce. 

■ The Ivcreait command and common options are shown below: 

# Ivcreate [-1 num^logicaLexienis \ -L size_in_MB] [-m 
num^mirrors] [-n Iv^name] [-p permissions] [-r relocate] [- C 
contiguous] 



Key 

-/ num_logtcaL 

extents 

-L size^m^MB 



-m num_ 
mirrors 
-n lv_name 

-p permissions 

-r relocate 

-C contiguous 



Operation 

Integer number of logical extents to be allocated 

to the created logical volume. 

Integer number of megabytes to be allocated to 

the created logical volume. May be rounded up 

by system. 

Specifies number of mirrors that contain the 

same data. Value can be 1 or 2. 

Simple file name (not path) of logical volume to 

be created. 

Permissions is w (read- write) or r (read-only). 

Default is read- write. 

Set bad block relocation, y = relocate (default), 

n — do not relocate bad blocks. 

Allocate physical extents with no gaps (required 

by root and dumps devices), n — allow gaps 

between physical extents (default), ?/ = do not 

allow gaps between physical extents. 
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/etc/lvdisplay 

■ Displays the characteristics and status of each logical volume 
specified by the Iv^path parameter. If the -v option is specified, 
hdispiay displays physical volume (PV) distribution information 
and map information about the physical extents corresponding to 
logical extents of the logical volume or volumes. 

■ The hdispiay command and options are shown below: 
# hdispiay f-v] Iv^paih . . . 

Key Operation 

-V Verbose. Displays extensive information about the 

logical volume(s) specified by h_path. 
Iv^path Path(s) of logical volume to be displayed. 

Example: /dev/vgXX/holY 



To display a generic logical volume: 
# hdispiay -v /dev/vgXX/holY 
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/etc/lvextend 

■ Increases the number of physical extents allocated to a logical 

volume. To limit the allocation to specific physical volumes, use the 
names of one or more physical volumes in phys_voLpath. 

m The Ivextend command and options are shown below: 



#lvexiend {-/ num^logicaLextents \ -L size_in_MB 
num^mirrors] Iv^path [phys^voLpath . . . ] 



■m 



Key 

-/ num_logical_ 
extents 



-L size_in^MB 



-m num_ 
mirrors 



lv_path 
phys^voLpath 



Operation 

Total integer number of all logical extents 
(existing + desired extension size). Number 
must be LARGER than the current logical 
extent allocation. 

Integer number of Megabytes to extend the 
logical volume. Number must be LARGER than 
the current size of the logical volume (existing + 
desired extension size). System may round up. 
Sets the number of physical extents allocated 
for each logical extent. Values can be 1 or 2. 
num_mirrors must be greater that the current 
number of mirrors for the logical volume. Data 
in the new copies is synchronized — this can be 
time consuming. 

Note: -m cannot be used on HP-IB devices. 
Path of logical volume to be extended. 

Example: /dev/vgXX/lvolY 

Path of physical volume(s) to extend on. 

Example: /dev/dsk/cXd0s2 
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/etc/Ivlnboot 

■ Prepares a logical volume to be root, primary swap, or dump 

volume. If a non-existent logical volume is specified, this command 
fails. If a different logical volume is already linked to the root or 
primary swap, the command fails. 

# Ivlnboot [-v] [-r root_lv] [-s swap_lv] f-d dump^lv] [-R 
voLgroup^name] 

Key Operation 

-V Verbose. With no other arguments, prmts 

information on all root volume groups. 

-r roo1_lv Defines root_lv to be the root volume the next time 
the system is booted on the volume group. Updates 
the Boot Data Reserved Area such that the volume 
group is used to locate the root file system. This 
allows the root_lv to be used as the root volume 
during a maintenance mode boot (ISL>hpux -Im 
(;0)hp-ux). The physical volumes must have been 
created using pvcreate -B, indicating that the 
physical volume is to be used as a Bootable 
Physical Volume. Also, mkboot must have been run 
on the Physical Volume. The root_lv must be a 
contiguous logical volume and cannot have Bad 
Block Relocation enabled. 

Example: -r /dev/vgXX/lvolY 
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Key Operation 

-s swap_h' Defines sivap^lv to be the primary swap volume 

next time the system is booted on the volume 
group. Updates the Boot Data Reserved Area. 
Any existing swap areas previously defined are 
removed. The swap^lv must be a contiguous 
logical volume, and a Root Logical Volume 
must have been previously defined by use of this 
command. 

Example: -s /dev/vgXX/lvolY 
-d dump^lv Defines dump_lv to be one of the dump volumes 

next time the system is booted on the volume 
group. Updates the Boot Data Reserved Area. 
The combined size of all the dump volume 
should be at least 2048 bytes larger than the 
total memory of the system. The additional 2 
Kbytes is used to safeguard against dump to the 
bottom of the disk. Multiple dump devices can 
be configured, but each dump^lv must be 
entered on a separate Ivlnhoot line. The 
dump_lv must be a non-mirrored, contiguous 
logical volume. 

Example: -d /dev/vgXX/lvolY 

-R voLgroup_ Recovers any missing links to all of the logical 

name volumes specified in Boot Data Reserved Area 

on each of the physical volumes in the volume 

group. Updates or rebuilds LIF's LABEL file. 

Example: -R /dev/vgXX 

Warning Any time a change is made to the Root Volume 

e Group (typically vgOO), run hlnbooi to update 

BDRA. If this is not done, the disk may not meet 
QUORUM requirements making the root disk 
unbootable. 
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/etc/lvmerge 

■ Merge to logical volumes of the same size, increasing the number of 
mirrored copies of the mast€r_lv_path by the number of copies in 
the backup _lv_paih. The data contained in the backup _lv_path is 
resynchronized using the data in the master^lv_path. All new data 
on the backup _lv-paih is lost. 

■ Whenever a mirrored logical volume is split into two logical 
volumes, a bitmap is stored that keeps track of all writes to either 
logical volume in the split pair. When the two logical volumes are 
subsequently merged using Ivmerge, the bitmap is used to decide 
which areas of the logical volumes need to be resynchronized. The 
bitmap continues to exist until the merge is completed, or until 
either of the logical volumes is extended or reduced, or the system is 
rebooted. 

■ If no bitmap is available, the entire logical volume is resynchronized. 

■ The normal usage for this command is to merge previously mirrored 
logical volumes that have been split (to allow off-line access to data 
for backup) using the Ivsplit command. However, the two logical 
volumes are not required to have been the result of a previous Ivsplit 
operation. 

■ The Ivmerge command and options are shown below: 
# Ivmerge backup -h_path master-h_path 

Key Operation 

backup _lv_path Logical volume path to be merged with master 

logical volume. 
master_hi_path Mirrored master volume path. 

To merge vgOO Ivollb (copy) with vgOO Ivoll (master): 
# Ivmerge /dev/vgOO/lvollb /dev/vgOO /Ivoll 
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/etc/lvreduce 

■ Reduces the number of physical extents allocated to a logical 
volume. 

■ The Ivreduce command and common options are shown below: 

# Ivreduce {-/ num^logicaLexients \ -L stze_in^MB \ -m 
num_mirrors} Iv^path 



Key 

-/ niim_logicaL 

extents 

-L size_in-MB 



-m num. 
mirrors 



lv_path 



Operation 

Integer number of logical extents to reduce 

logical volume. 

Integer number of Megabytes to reduce the 

logical volume. 

Set the number of physical extents (mirrors) 

allocated for each logical extent. Value may be 

= no mirror; or 1 = one mirror copy. 

num_mirrors must be less than the current 

number of mirror copies. 

Path of logical volume to be reduced. 

Example: /dev/vgXX/lvolY 



To reduce vgXX, logical volume Y by 100 MB: 
# Ivreduce -L 100 /dev/vgXX/lvolY 



Warning 







Reduce the size of a logical volume ONLY if you 
no longer need its current contents, or if you 
have safely backed up the contents to tape or to 
another logical volume. 
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/tic/lvrerTLOVt 

■ Removes the logical volume or volumes specified by lv_path. Logical 
volumes must be unmounted before removal. 

■ The Ivremove command and options are shown below: 
# Ivremove f-f] Iv.path . . . 

Key Operation 

-/ Specifies that no user confirmation is required. 

Iv^paih Path(s) of logical volume to be displayed. 

Example: /dev/vgXX/lvolY 



To remove a generic logical volume: 

# umount /dev/vgXX/UvolY 

# Ivremove /dev/vgXX/lvolY 
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/etc/Ivrmboot 

m Updates all physical volumes contained in volume group such that 
logical volume is removed as the root, primary swap, or a dump 
volume when the system is next booted on the volume group. 

■ The Ivrmboot command and options are shown below: 

# Ivrmboot f-v] f-r] f-s] [-d dump_lv] voLgroup^name 

Key Operation 

-V Prints verbose messages. 

-r Removes definitions of the root, primary swap, 

or dump volumes from the given volume group. 

Updates Boot Data Reserved Area. 
-s Remove definition of the primary swap volume 

and all dump volumes from the given volume 

group. Updates the Boot Data Reserved Area. 
-d Remove definition of dump_lv as one of the 

dump volumes. Updates the Boot Data 

Reserved Area. 
voLgroup_name Name of aff"ected volume group. See examples 

below\ 

To remove a dump logical volume: 

# Ivrmboot -v -d /dev/vg00/lvol6 

To remove a root from volume group zero: 

# Ivrmboot -r /dev/vgOO 
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/etc/lvspUt 

m Ivsplit splits singly- or doubly mirrored Iv^path into two logical 
volumes. A new logical volumes is created containing one copy of 
the data. 

■ If suffix is specified, the new logical volume is given the name 
lv_p{iihsujjix . ii. suffix is not specincu, tvspiii assigns a new name 
using the suffix b. 

m Whenever a mirrored logical volume is split into two logical 

volumes, a bitmap is stored that keeps track of all writes to either 
logical volume in the split pair. When the two logical volumes are 
subsequently merged using Ivmerge, the bitmap is used to decide 
which areas of the logical volumes need to be resynchronized. This 
bitmap remains in existence until the merge is completed, or either 
of the logical volumes is extended, reduced, or spht again, or the 
system is rebooted. 

■ The new logical volume must be checked with fsck before mounting. 
Ivsplit flushes the file system to a consistent state except for pipes 
and unlinked but open files. 

■ The Ivsplit command and options are shown below: 
# Ivsplit f-s suffix] Iv^path 

Key Operation 

-s suffix Assigns the characters supplied in suffix to the end 

of the logical volume name. 

Example: -5 backup 
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To split an on-line logical volume which is currently mounted on 
/usr so that a backup can take place: 

# Ivsplit /dev/vgOO/lvolS 

# fsck /dev/vgOO/lvom 

# mkdtr /IvolSh 

# mount /dev/vg00/lvol3b /IvolSb 

# /backup -f /dev/rmt/Oh -OvHi /IvolSb (backup using 
appropriate backup utility and string) 

To merge the split pair after backup: 

# umount /IvolSb 

# Ivmerge /dev/vg00/lvol3b /dev/vgOO/lvoW 
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/etc/lvsync 

■ The Ivsync command synchronizes the physical extents of the 
logical volume specified by Iv-path. Synchronization occurs only on 
physical extents that are stale mirrors of the original logical extent. 
The synchronization process can be time consuming depending on 
the hardware and amount of data. 

■ The IvsplH command and options are shown below: 
# Ivsync lv_path 

Key Operation 

Ivpath The logical volume path of the master logical 

volume. 

Example: /dev/vg00/lvol3 



To resynchronize the mirrors on a logical volume: 
# Ivsync /dev/vg00/lvol3 
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/etc/mkboot 

m The mkboot command is used to install or update boot programs 
on the disk specified by the associated device file. Must be in 
single-user mode. 

■ The mkboot command and common Series 800 options are shown 
below: 

# mkboot [-b boot^file^path] device 

# mkboot f-b boot^file^pathj f-i included_lif_filej [-1] [-p 
preserved_lif_file] f-v] device 

# mkboot [-a auto_file_string7 device 

Key Operation 

-b boot_file_path Boot programs in the pathname specified are 
installed on device. 

device Character or Block special file associated with 

the disk. 

-I included_ If specified one or more times, mkboot copies 

lif-file each file specified by mcluded^lif^fik and 

ignores any other LIF files in boot_file^path. 
The sole exceptions are the files ISL and 
HPUX, which are always copied. If LABEL is 
specified in included_lif_file and LABEL is not 
present on the boot disk's LIF, a minimal 
LABEL file is created allowing boot possibly 
without swap or dump. 

-/ Treat disk specified by device as an LVM 

physical volume, regardless of whether or not it 
is currently set up as one. 
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Key Operation 

-p preserved_ If specified one or more times, mkboot will not 
lif^fik overwrite the LIF file specified by 

preserved^lif^file. Typically used to prevent 
overwriting AUTO and with LVM and 
SwitchOver/UX file LABEL, li ■preserved^lif_file 
is not on the specified disk, mkboot fails. 
-a '^auio_boot_ If the -a option is specified, mkboot creates or 
siring" updates the AUTO file on the disk specified by 

device. The autoboot string must have quotes if 
it contains blank spaces. 

Example: -a "hpur (52.6.0;0)/hp-ux" 

Note The default file used as source for mkboot is 

/usr/lih/uxhooUf . 



4 



To copy all LIF utilities from /usr/hb/uxbootlf to boot disk 
LU 0: 

# mkboot /dev/rdsk/c0d0s2 (LVM File System) 

To copy and update LIF's AUTO file with boot string information 
on LU 0: 

# mkboot -a "hpux (;0)/hp-ux" /dev/rdsk/c0d0s2 (LVM File 
System) 
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/etc/pvcreate 

■ Initializes a raw disk device for use as a physical volume in a volume 
group. If pvcreate recognizes a pre-existing file system, it asks for 
confirmation. Command fails if the disk already belongs to a volume 
group. 

■ The pvcreate command and options are shown below: 

# pvcreate [-b] f-f] [-B] [-t disk_type] [-d soft_defects] phys_voLpath 

Key Operation 

-h Used to specify the numbers that correspond 

indexes of all known bad blocks on physical 
volume phys_voLpath. Specify indexes using 
decimal, octal, or hexadecimal numbers in 
standard C-language notation with numbers 
separated by new-line, tab, or form-feed 
character. If this option is not used, pvcreate 
assumes that the physical volume contains no 
bad blocks. 

-/ Force creation of a physical volume (thus 

deleting any file system present) without 
requesting information. 

-B Make a physical volume bootable. 

-/ disk_type Retrieve configuration information about 

disk_type from /etc/disktab. 

-d soft^defects Specify minimum number of bad blocks that 
LVM should reserve for bad block relocation. 
Number <= 7039. Not supported on HPIB 
disks. 

phys^voLpath Character device file for target disk. 

Example: /dev/rdsk/cld0s2 
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/etc/pvchange 

■ Changes the characteristics and state of a physical volume by 
setting the allocation permission to allow or deny allocation of 
additional physical extents. 

■ The pvchange command and options are shown below: 
# pvchange -x extensibility phys^voLpath 

Key Operation 

-X extensibility Set allocation permission for additional physical 
extents on the physical volume specified. 
Extensibihty has two allowed values: y = allow 
extension, n = do not allow extension. 

phys^voLpath Path of physical volume to be added to the 
volume group. 

Example: /dev/dsk/cXd0s2 

To deny allocation on a generic physical volume: 
# pvchange -x n /dev/dsk/cXd0s2 



File Systems 6-55 



/etc/pvdisplay 

■ Displays information about the physical volume or volumes specified 
by the phys^voLpath parameter. If the -v option is specified, 
pvdisplay displays a map of the logical extents that correspond to 
the physical extents of each physical volume. 

■ The pvdisplay command and options are shown below: 
# pvdisplay [-vj phys^voLpath . . . 

Key Operation 

-V Verbose. Displays extensive information about 

the physical volume(s) specified by 
phys^voLpath. 

phys^voLpath Path(s) of physical volume(s) to be displayed. 

Example: /dev/dsk/cXd0s2 



To display extensive information on LU3 and LU4: 
# pvdisplay -v /dev/dsk/c3d0s2 /dtv/dsk/c\d0s2 
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/tic/'pvmovt 

■ Move allocated physical extents from one LVM physical volume to 
one or more LVM physical volumes. The pvmove command succeeds 
only if there is enough space on the destination(s) to hold all of the 
source physical extents. Source and destination must reside in the 
same volume group. 

■ The pvmove command and options are shown below: 

# pvmove [-n Iv^path] source^pv_path [dest_pv^path . . . ] 

Key Operation 

-n lv_path Moves only allocated physical extents associated 

with lv_path. 

Example: /dev/vgXX/lvolY 
source _pv_path Block device file of source physical extents. 

Example: /dev/dsk/cXd0s2 
dest^pv_path Block device file(s) of destination device(s). 

Example : /dev/dsk/c i 'd0s2 
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Backup of LVM Data Structures With /etc/vgcfgbackup 

m The vgcfgbackup command creates or updates a backup of LVM 
volume group data structures (PVRA, VGRA, and where apphcable 
on a bootable LVM disk, BDRA) mto a file. 

Warning without an up to date copy of the LVM data 

e structures vgcfgbackup creates, It is IMPOSSIBLE 

to recover from most, If not all, LVM problems. 
Volume groups MUST be backed up with 
vgcfgbackup after ANY Changes to the group. It is 
highly recommended that all volume groups be 
backed up dally using cron(lM). 



The default path for the backup is 

/etc/lvmconf/voLgroup_name.conf 

The vgcfgbackup command and options are shown below: 

# vgcfgbackup [-u] [-f vg_conf_path] voLgroup^name 

Key Operation 

-u Updates configuration file with latest LVM 

configuration. 
-/ vg_conf_path Saves configuration in file specified by 

vg_conf_paih. 

Example: -/ /my/backup/paih/myvol.conf 
voLgroup_name Name of the volume group to backup. 

Example: /dev/vgXX 
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Recovery of LVM Data Structures With /etc/vgcfgrestore 

■ The vgcfgrestore command restores LVM data structures (PVRA, 
VGRA, and where apphcable on a bootable LVM disk, BDRA) from 
a vgcfgbackup created backup file. 

■ The default path for the backup file to be used by vgcfgrestore is 
/ 1 tc/ ivniconf/ voi^ groups nanit. conf . 

■ The vgcfgrestore command and options are shown below: 

# vgcfgrestore {-n voLgroup^name \ -f vg^ conf _ path] -I 

# vgcfgrestore {-n vol_group_name \ -f vg^conf^path} [-0 
old_pv_path] pv^path 

Key Operation 

-n voL Specify the volume group name of the backup file. 

group_name „ , 

Example: -7? vgul 

-f vg^conf_ Specifies the entire path to the vgcfgbackup file. Do 

path not use with -n. 

Example: -/ /my /backup /path/myvol. conf 

(created with vgcnfgbackup -/). 
-/ List information in vgcfgbackup backup file. 

-0 old_voL LIsed to restore configuration information saved for 
path physical volume old path pv path. This is used 

when a physical volume's name has changed since 

backup. 
pv_path Physical device path volume group file is to be 

restored. 

Example: /dev/rdsk/cldOs2 



To restore the LVM data structures on volume group vgYY: 

# vgchange -a n vgYY 

# vgcfgrestore -n vgYY /dev/rdsk/cXd0s2 
■^ vgchange -a y vgYY 
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/etc/vgchange 

u Activates or deactivates one or more volume groups as specified by 
the -a option; namely y ot n. 

m Before deactivating a volume group, make sure that all logical 
volumes in the volume group(s) are unmounted with the umouni 
command. 

■ The vgchange command and non-mirror options are shown below: 

# vgchange -a availability [-q quorum] [-1] [-p] [-s] 
voLgroup_nam€ . . . 

Key Operation 

-a availability Activate or deactivate the volume group. 

Availability has two allowed values: y = volume 
group is available, n = volume group is 
temporarily unavailable. When mirrors are 
involved, activating a group will perform the 
necessary mirror consistency recovery based on 
the state of the Mirror Write Cache and Mirror 
Consistency Recovery section of Ivdisplay. See 
vgchange(lM) and Ivdisplay(lM) for details. 

-q quorum Set activation of quorum requirement for the 

volume group. Qdefault), n = ignore quorum 
requirement. 

-/ Do not allow open of logical volumes that 

belong to the volume group(s) specified. 

-p Activate volume group only if all physical 

volumes in group are available. 

-s Disable synchronization of stale physical extents 

within the volume group. Only applies to LVM 
mirrored disks. 
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/eic/vgcrtate 

■ Creates a new volume group. voLgroup_name is a symbolic name 
for the volume group and must be used in all references to it. 
voLgroup^name is the path to a directory under /dev which must 
contain a character special file named group. Except for the group 
entry, no other files must be present on /dev/voLgroup^name. 

■ The vgcreate command and common options are shown below: 

# vgcreate f-x extensibility] [-e max_phys^ extents] [-1 
max-logicaLvols] [-p max^logicaLvols] [-s phys_extent_size] 
voLgroup^name phys^voLpath . . . 



Key 

-X extensibility 



-e max_phys^ 
extents 

-I max_logical. 
vols 



-p max_logical_ 
vols 

-s phys_extent_ 
size 



vol_group_name 



phys-VoL path 



Operation 

Set allocation permission for additional physical 
extents on the physical volume specified. 
Extensibility has two allowed values: y = allow 
extension, n = do not allow extension. 
Integer number sets maximum number of 
physical extents. Default maximum 1016. 
Kernel tunable with maxpxs. 
Integer number sets maximum number of logical 
volumes that a volume group can contain. 
Default maximum is 255. Kernel tunable with 
maxlvs. 

Integer number sets maximum number of 
physical volumes allowed in a volume group. 
Default is 255. Kernel tunable with maxpvs. 
Integer number sets the number of megabytes in 
each physical extent. Values in Mbytes may 
range from 1- 256. Value must be a power of 2 
(i.e., 1, 2, 4, 8, 16 ... 128, 256). 
Name of volume group to be created. 

Example: /dev/vgXX 

Block device file(s) associated with the disk 

drive(s) to be added to the volume group. 

Example: /dev/dsk/cXd0s2 
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To create a generic volume group on two disk drives: 

# vgcreate /dev/vgXX /dev/dsk/cYd0s2 /dev/dsk/cZd0s2 
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/etc/vgdisplay 

m Displays information about volume groups. If the volume group 
name is specified, vgdisplay displays information for that volume 
group only. If no volume group name is specified, vgdisplay displays 
names and corresponding information for all defined volume groups. 

■ The vgdisplay command and options are shown below: 

# vgdisplay [-v] [voLgroup^name ■ ■ ■ ] 

Key Operation 

-V Verbose. Displays extensive information about 

the volume group(s). 
voLgroup^name Path(s) of volume group to be displayed. 

Example: /dev/vgXX 



To display extensive information from a generic volume group: 
# vgdisplay -v /dev/vgXX 
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/etc/vgexport 

■ Removes a volume group from the system without modifying the 
logical volume information as found on the physical volume(s). 
Volume group information is removed from /etc/lvmtab file, and the 
associated device files including the volume_group_name directory 
are removed from the system. Useful in moving a volume group 
from one system to another. 

■ The vgexport command and options are shown below: 
# vgexport f-p] [-v] [-m mapfile] voLgroup^name 



Key 

-P 



■m mapfile 



Operation 

Preview actions to be taken but do not make 
any changes. Best used with the -v option. 
Verbose. Prints the name(s) of the physical 
volumes associated with the volume group 
specified by voLgroup^name. 
Specify the name of the file to which logical 
volume name(s) and numbers are to be written. 
If no name is specified, no file is written, mapfile 
is used as input to the vgimpori command. 



Example: /vgXXmap 
voLgroup^name Name of volume group to export. 

Example: /dev/vgXX 
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/etc/vgexttnd 

■ Extends a volume group by adding physical volumes to it. 

■ The vgextend command and common options are shown below: 
# vgextend [-x extensibility] voLgroup-name phys^voLpath 

Key Operation 

-X extensibility Set allocation permission for additional physical 
extents on the physical volume specified. 
Extensibility has two allowed values: y = allow 
extension, n = do not allow extension. 

voLgroup-name Name of affected volume group. 

Example: /dev/vgXX 
phys-VoLpath Path of physical volume to be added to the 
volume group. 

Example: /dev/dsk/cXd0s2 
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/etc/vgimport 

■ Adds the specified volume group to the system. The physical 
volumes to be added are scanned to obtain volume group 
and physical volume information. A volume group directory 
(/dev/vgXX) and character group file must have been created prior 
to invoking this command, vgtmport works in a similar manner 

to vgcreate, but does not activate the group (use vgchange -a to 
activate), /etc/lvmtab is updated to reflect changes. 

■ The vgimpori command and options are shown below: 

# vgimpori [-p] f-v] f-m mapfile] voLgroup^name phys^voLpath . . . 



Key 

-P 

-V 

-m mapfile 



Operation 

Preview actions to be taken but do not make 
any changes. Best used with the -v option. 
Verbose. Prints the name(s) of the physical 
volumes associated with the volume group 
specified by voLgroup^name. 
Name of file created by vgexpori . If not 
specified, import with standard naming 
conventions (i.e., [rJlvolX). 



Example: /vgXXmap 
voLgroup-uame Name of volume group to import. 

Example: /dev/vgXX 
phys_voLpath Block device files of physical volumes to be 
imported. 

Example: /dev/dsk/cXd0s2 
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/ttc/vgvtduct 

■ Reduce a volume group by removing one or more physical volumes. 
All but one physical volume can be removed. The last physical 
volume can be removed by vgremove. All logical volumes residing 
on the physical volume must be removed by executing Ivremove 
before executing vgreduce. 

m The vgreduce command and options are shown below: 

# vgreduce voLgroup^name phys-VoLpath 

Key Operation 

voLgroup^name Name of the volume group to reduce. 

Example: /dev/vgXX 
phys^voLgroup Block device file(s) associated with the disk 

drive(s) to be removed from the volume group. 

Example: /dev/dsk/cXd0s2 



To remove a generic physical volume from a volume group: 
# vgreduce /dev/vgXX /dev/dsk/cYd0s2 
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/etc/vgremove 

■ Removes the last physical volume from the volume group and the 
definition of the volume of the group(s) specified. When completed, 
the volume can no longer be accessed. 

■ Before removing a volume group, two steps are necessary: 

1. Remove all but one of the logical volumes belonging to the 
volume group with Ivremove. 

2. Remove the physical volume(s) in the volume group with 
vg reduce. 

■ The vgremove command and options are shown below: 
# vgremove voLgroup^name . . . 

Key Operation 

voLgroup^name Name(s) of volume group(s) to be removed. 
Example: /dev/vgXX 



To remove two generic volume groups: 
# vgremove /dev/vgXX /dev/vgYY 
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/ttc/vgscan 

■ Searches physical volumes connected to the system, looking for 
logical volumes. It then groups these into volume groups. It 
searches the /dtv directory for all group volume files with LVM 
major numbers (64). After analyzing the information, it updates 
/eic/lvrntab with this information. 

■ Move /etc/lvmtab before invoking vgscan. 

m The vgscan command and options are shown below: 
# vgscan f-p] f-v] 

Key Operation 

-p Preview the actions taken but do not update 

/etc/lvmtab . This option is best used in 
conjunction with the -v option. 

-v Verbose. 

To update /etc/lvmtab by scanning the system: 

# mv /etc/lvmtab Ivmtab.old 

# vgscan -p -v (preview changes to /etc/lvmtab) 

T^t vgscan -v (create and update /etc/lvmtab with current system 
information) 
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/etc/vgsync 

■ vgsysnc synchronizes the physical extents in each mirrored 
logical volume in the volume group specified by voLgroup^name. 
Synchronization occurs only on the physical extents that are stale 
mirrors of the original logical extent. 

Unless disabled, the mirrors within a volume group are synchronized 
automatically when the volume group is activated by the 
vgchange -a y command. 

■ The vgsync command and options are shown below: 
# vgsync voLgroup^name 

Key Operation 

voLgroup^name The path of the volume group to be 
synchronized. 

Example: /dev/vgXX 

To synchronize vg03: 
# vgsync /dev/vgOS 
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7 



Cookbook Procedures 



Spool-A-Printer Cookbook 

1. Verify that the kernel contains the required interface and printer 
driver(s) (see Installing Peripherals HP 9000 Series 800 Computers, 
HP Part Number B31 08-90004 for driver information): 

i^ Isdev 

If the required device driver(s) are not present in the kernel, 
add driver include statement(s) (e.g., include IprO;) to the 
/etc/conf/gen/S800 file. Use uxgen to generate a new kernel. 
Once this has been accomplished, reboot the computer on the 
new kernel. 

2. Use ioscan to bind the necessary driver(s) to the new printer: 

# ioscan -f 

Verify that the hardware and software status is ok for the 
printer's hardware path. 

3. Assign logical unit numbers and make default device file(s) for any 
new hardware detected by the ioscan command: 

# cd /dev ; insf 

4. Find the printer's model/interface script: 

# II /usr/spool/lp /model \ more 

5. Identify the printer's device file: 

# Issf /dev/lp* (for non-serial printer) 

# Issf /dev/t1y?p? (for serial printer) 
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6. Verify that the printer's device file is owned by 'Ip': 

# II /dev/devicefile (use device file found in Step 5 above) 

To change ownership type: # chown Ip /dev/devicefile (use 
device file found in Step 5 above). 

7. Configure the printer into the LP Spooler: 

# Ipshut 

# Ipadmtn -pprinter_name (user's choice) -I'/dev/devicefile (from 
Step 5 above) -mhpMODEL (from Step 4 above) 

# accept printer_name 
9^: enable printer_name 

# Ipadmtn -(/printer_name (execute this line if the spooled 
printer is the default printer) 

# Ipsched 

8. Test the printer using LP Spooler, then check LP Spooler's status: 

# Ip -rfprinter_name /etc/passwd 

# Ipstai -t 
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Add-A-Serial-Printer Cookbook 

1. Connect the serial printer to an available serial port on a 
multiplexer panel (do not use the Access Port). 

2. Verify that a device file exists for the new printer: 

# issf /dev/ttyXpY 

Where: 

X — logical unit (lu) number of the mux assigned by insj . 

Y — port number the printer is attached to. 

muxO lu X port Y hardwired address mod. slot /dev/tiyXpY . 

If Issf fails to find the desired device file, check to see that the 
insf process has been correctly followed. If the kernel (hp-ux) has 
been configured correctly, mksf can create a new device file for 
the printer. 

# cd /dev 

# /etc/mksf -d muxN -I X -p Y -h /dev/iiyXpY 

Where: 

muxN = mux driver name (e.g., muxO, muxl, mux2) 

A' = logical unit (lu) number of the mux assigned by insf. 

Y = port number the printer is attached to. 

3. Edit /eic/inittab using vi or ed. Delete any existing lines which 
refer to the device file that will be used by the new serial printer. 

4. Configure the printer into the LP spooler using the steps in the 
Spool- A-Printer Cookbook earlier in this section. 
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Printer/Spooler Troubleshooting Cookbook 

1. Check the hardware to see that it is cabled correctly, powered 
on, addressed correctly, and on-line. If possible, run the printer's 
self-test. 

2. Check the printer's hardware and software status in the kernel: 

:j^ loscan -kf 

If the kernel does not indicate that the status of the printer's 
path is ok, check to see that the kernel has the necessary drivers 
using Isdev. If a drivers is missing, see the Spool- A-Printer 
Cookbook for details on adding drivers to the kernel. 

3. Check the printer's device file for ownership and permissions: 

9^ II /dev/printers-device^file 

If not owned by Ip, change device file ownership by typing: 
chown Ip /dev /printers^ device _fHe. 

4. Attempt to bypass the Ip spooler by outputting directly to the 
printer's device file: 

■ For HP-IB printers, type: 

# cat /etc/passwd > /dev/lpX 

m For serial printers, type the following: 

# nohup sleep 2000000000 < /dev/ttyXpY & stty -parenb \ 
-ienqak cs8 9600 -cstopb -clocal ixon -opost < /dev/ttyXpY 

Where: /dev/ttyXpY = the printer's device file. 9600 = the 
printer's baud rate. 

# cat /etc/passwd > /dev/ttyXpY 

m If you receive some form of printout (perhaps without proper line 
feeds, etc.), the fundamental path to the printer is working. The 
LP spooler has software configuration problems. 
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Determine the LP Spooler's Status: 
9^ Ipsiat -t 

■ If there is no evidence of the troubled printer, it has not been 
configured into the LP Spooler. Add it using the Add-A-Serial- 
Printer Cookbook and/or Spool-A-Printer Cookbook in this 
section. 

■ If the printer has been spooled but fails to print, try the 
following: 

n If Ipstat indicates scheduler is not running, start it using 
Ipsched: 

# Ipsched 

o If Ipstai indicates that the system has no default destination 
printer, assign one using Ipadmin -d: 

# Ipadmin -dprinter^name 

a If Ipstat indicates that the printer is rejecting requests, using 
the accept command: 

# accept printer_name 

a If Ipstat indicates that the printer is disabled, enable it using 
the enable command: 

# enable printer^name 

If the above procedure fails to remedy the problem, try removing 
the printer from the LP Spooler using the Remove- A-Spooled 
Printer Cookbook, then add the printer again using the 
Add-A-Serial Printer Cookbook and/or the Spool-A-Printer 
Cookbook. 
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Add-A-Terminal Cookbook 

1. Connect the terminal to an available port on one of the mux panels 
(do not use the Access Port for this purpose). 

2. Verify that a special device file exists for the new terminal: 

# Issf /dev/ttyXpY 

Where: 

.Y = logical unit (lu) number of the mux assigned by msf . 
Y = port number the terminal is attached to. 

muxN lu X port Y hardwired address mod. slot /dev/ttyXpY . 

If insf fails to find the desired special device file, run toscan to 
see if the MUX card has been configured correctly. If it has, mksf 
can create a new special device file for the terminal: 

# cd /dev 

# /etc/ mksf -d muxN -I X -p Y 

Where: 

muxN = name of the mux driver (e.g., muxO, muxl, mux2) X 

and Y have the same meaning as above. 

3. Modify /etc/tmttab using vi or ed. Delete any existing lines 
which refer to the special device file that will be used by the new 
terminal. 
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4. Add the following line to /etc/initiab: 

xx:2:respawn:/etc/geUy -h ttyXp Y 9600 
Where: 

Key Operation 

XX Unique one or two character identification. 

2 Run level (typically 2 for multiuser terminal 

operation). 
A' Multiplexer's logical unit (lu) number assigned by 

msf . 
Y Port number terminal is attached to. 

9600 Terminal baud rate. 

5. Force init to read the /eic/iniiiab file: 

# ielinii q 

If communication with the terminal fails, verify the hardware, 
terminal configuration, and /eic/imttah file making any 
necessary changes. After making any necessary changes invoke 
the following commands: 

# ps -ef (to locate getty processes running against new 
terminal). 

# kill -9 PID# (kill process ID(s) associated with ttyXpY). This 
will automatically spawn a new getty process for the terminal. 

6. Test the new terminal by attempting to login. 
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Add-A-Diahin Modem Cookbook 

1. Connect the MODEM to an available port on one of the mux 
panels (do not use the Access Port or ports 3 - 5 on the synapse 
panel). 

2. Create a special device file for the new dial-in modem: 

# mksf f-d muxN [-1 lu] f-p port] [-h \ -i \ -o] [-c] [path] 
Where: 

Key Operation 

-d muxN Specifies mux driver name to be used. 

-/ Logical unit number (lu) of the device assigned 

by insf . 
path Default path name is tty<lu>p<port>. 

-c CCITT (European Standard). 

-h Hardwired (direct connect). 

-I Callin MODEM. 

-0 Callout MODEM. 

-p Multiplexer port number to which the MODEM 

is attached. 

For example: to make a dial-in MODEM special device file for 
mux lu 2, port 2: 

# cd /dev 

# mksf -d muxO -I 2 -p 2 -i ttyd2p2 

Where: 

-I specifies callin MODEM. 

ttyd2p2 is the special device file name. 

3. Edit /eic/initiah using vi or ed. Delete any existing lines which 
refer to the mux and port used by the new MODEM. 
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4. Add the following line to /etc/imiiah: 

xx:2:respawn:/etc/geUy -h -t ZZZ ttydXpY 2400 
Where: 

Key Operation 

XX Unique one or two character identification. 

2 Run level (typically 2 for multiuser MODEM 

operation). 
ZZZ Integer timeout value in seconds. 

X Multiplexer's logical unit (lu) number assigned by 

insf . 
Y Port number MODEM is attached to. 

2400 MODEM baud rate (e.g, 1200, 2400, 9600). 



5. Force inii to read the /etc/inittab file: 

9^ telinit q 

If communication with the MODEM fails, verify the hardware 
connections, MODEM configuration switches, and the associated 
/etc/inittab getty line. Make any necessary changes. After 
making necessary changes invoke the following commands: 

# ps -ef (locate getty processes running against new MODEM). 

# kill -9 PID# (kill process ID(s) associated with ttydXpY). 
This will automatically spawn a new getty process for the 
MODEM. 

6. Test the new dial- in modem by attempting to login from a remote 
location. 
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HP-UX Network Installation Cookbook 

1. Install networking software by running /etc /update. Load all 
software in the NETWORKING partition. 

2. Edit /etc/rc using vi or ed. Make the following change to the 
imtiahzeO function: 



From — 

SYSTEM_NAME=unknown 

To read — 

S YS TEM_ NA ME= bashfu I 

Where; bashful is the user chosen system host name. This name 
must be unique among all the machines connected to this LAN. 

CdUtion Networking errors may result if the system name 

specified by /etc/rc and /etc/src.sh do not agree! 



• 



3. Edit /etc/hosts. Add a line for each host in the network to be 
accessed. Include a line for the computer you are on. Each line in 
/etc/hosts must begin with Internet Protocol (IP) address, followed 
by the official hostname, then any hostname aliases. 

Caution ■ Each Internet Protocol address must begin in 

column 1 of the /etc/hosts file. 



• 



Internet addresses must begin in column 1 of the 
line. 

Do not use leading zeros in the Internet Protocol 
Address. As an example 015.032.06^.001 should 
be entered as 15.32.64-1 

The last number following the final decimal (.) 
cannot be zero. As an example 15.32.64-0 has a 
final zero and is NOT allowed. 
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For example 






192.6.1.1 


bashful 


shy 


192.6.1.2 


grumpy 


maddog 


192.6.1.3 


doc 




192.6.1.4 


sleepy 





4. Edit the first if/else clause in the /etc/nethnkrc script. Making 
the following changes to set the customer chosen DOMAIN and 
ORGANIZATION that this host will belongs to: 

From — 

ROOTSERVER='hostname' 
NODENAME=$ROOTSERVER 
DOMAIN='bin/uname -n' 
ORGANIZATION=standalone 

To read— 

ROOTSERVER='hostname' 
NODENAME=$ROOTSERVER 
DOMAlN=customer_chosen_domain..name 
0RGANlZATl01>i= customer_chosen_orga7iization^name 

5. Shutdown and reboot, the system: 

*cd/ 

if: shutdown -r 
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6. Verify the hardware connection by running the landad diagnostic; 

a. Run landad using the default sections to obtain the LAN card's 
hex station address: 

# sup lice n 

# sysdiag 

DUI> landad pdev=2/4-3 (2/4.3 = the LAN interface "s 
hardware address) 

b. Run landad again specifying section 9. This will test the MAU. 
Use the hex station address obtained in the previous Step: 

# /usr/diag/hin/sysdiag 

DUI> run landad pdev=2/4-S section=9 

If desired, repeat this for other hosts with known hex station 
addresses on the LAN. Each host must be connected to the 
LAN and powered on. It is not necessary for these hosts to be 
running HP- UX for this test to pass. 

7. Check the network packet passing capability by using ping. First 
ping the host your are on, if this is successful, pmg host directly 
connected to the LAN. Each host must be configured as above and 
booted up. 

# ping bashful 

# ping grumpy (Note: Use Cirl-c to stop ping) 
9^ ping doc 

i^ ping sleepy 
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Verify the Telnet feature of ARPA: 
# telnet grumpy 
login: root 
password: 

(allows session from terminal with no screen mode capability) 
Ctrl-d (exits Telnet) 
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Add-A-User Cookbook 

1. Add a login line to /eic/passwd using vi or ed: 

caitlin::215:200:caitlin x8174-'/mnt/us€rs/caithn:/bin/sh 

/eic/passwd format: 

user_nanie:password:user_id:group_id:comment_field:\ 
login_directory:command 

2. Add or modify a line in /etc/group using vi or ed (optional): 

ces::200: (May exist if others in new user's group) 
lah::300:caiUin (Add to access other group privileges) 
/etc /group format: 
group_name:password:group_id:memberl,member2 

3. Make the user's login (or home) directory: 

# mkdir /mnt/users/caithn 

4. Change the owner oi /mnt/users/caiilin from root to caitUn: 

9^ chown catilin /mnt/users/caithn 
chown syntax: 

# chown owner file 

5. Change the group ownership oi /mnt/users/caitltn from other to 
ces (or 200): 

# chgrp ces /mnt/users/caitlin 
chgrp syntax: 

# chgrp group file 

6. Login to the new account. 

7. Copy or create a shell customization script (e.g., cp /etc/d. profile 
SHOME/d. profile). 
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Memory Core Dumps 

■ If HP-UX gets a High Priority Machine Check (HPMC) or panics, 
the kernel will automatically write an image of the entire physical 
memory onto the primary swap device. 

■ After the HPMC or panic and the memory write to swap, the kernel 
halts present processes and attempts to reboot. On reboot /tic /re 
will invoke /etc/savecore. savecore recognizes the attempt to save 
the memory image on the primary swap or dumps device into two 
files on the imp file system. Normally the destination of the files, 
hp-ux.X and hp-core.X , is the /tmp/syscore directory. 

■ The size of imp should be larger than physical memory to enable 
it to hold a full memory dump. If the size of imp is smaller than 
physical memory, savecore will store only a portion of the dump on 
imp; the rest will be lost. To clear a dump without saving it, at the 
shell prompt type: /etc/savecore -c /imp 

m /etc/savecore will clear special bits on the primary swap device 
when the entire dump has been saved to files on the file system. On 
subsequent reboots, /etc/savecore will not recognize that a dump 
resides on the primary swap device. 
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Modifying /etc /re to Save iVIemory Dumps 

1. Execute the hdf command. Select a file system which contains more 
free space than the size of physical memory. Note the associated 
mount_point_directory: 

# /usr/hin/hdf (see hdf command described earlier) 

2. Make a sy score directory on the mount_point_directory selected in 
step 1 above: 

# /bin/mkdir /mount^poini_directory/syscor€ 

3. Using vi or ed, make the following changes to the save^core 
function in the /etc/rc file: 



From — 

if [ -X /etc/savecore ] && [ -d /imp/syscore ] 

then 

/etc/savecore/tmp/syscore 

To read — 

if [ -T /etc/savecore ] && [ -d /mount^point^directory/syscore ] 

then 

/etc/savecore /mount-point^dtrectory/syscore ] 

4. After a memory dump and subsequent reboot, two files will be 
saved on the directory created in step 2. These are: 

/mount_point_ direct ory/syscore/hp-ux.X 

and 

/mounts points direct ory/syscore/hp- core. X 

Where: The trailing A' in the file name is an integer number: the 
first dump saved is zero (0), the next 1. etc. 
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Add Dynamic Swap Cookbook 

To add dynamic swap space on a high performance file system (HFS), 
perform the following steps: 

1 . Find a file system with sufficient free space to add dynamic swap 
space, without filling the file system and preventing users from 
storing files: 

# /usr/hm/hdf -b 

2. Use swapon to create the desired dynamic swap space on the file 
system selected in the previous Step: 

9^ /etc/swapon mouni^point_dir min_blocks max_hlocks \ 
fs-reserve_blocks priority 

Where: 



Key 

mouni_point^dir 



m.in_blocks 



max^blocks 



fs^reserve. blocks 



priority 



Operation 

Full path name of mount_point_ directory 
where the file system dynamic swap is to 
reside. 

Minimum number of file system blocks to 
be allocated for dynamic swap (0 = do 
not take any blocks at swapon). 
Maximum size in blocks dynamic swap is 
allowed to take from the file system (0 = 
take as many blocks as necessary). 
Number of file system blocks that are 
saved for file system use only (0 = no 
blocks reserved for the file system). 
Indicate the order space is taken from the 
file system for use as swap (priority zero 
file systems are taken first). 



min, max, and fs^reserve^blocks size must be specified as an 
integer number of file system blocks. The size of the file system 
blocks can be found in /etc/dtsktab for the model and section 
number of the disk that attaches to the mount_point_directory. 
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NOtG Once swap is enabled by swapon, rmn_blocks and 

I fs^reserve. blocks cannot be changed, but max^blocks 

MH can be increased in size. 

3. If dynamic swapping is to be made permanent (enabled on system 
start-up) add a line to /etc/checklist in the following format using 
vi or ed: 

/dev/dsk/cXdOsY mount_point^dir swapfs min=A, lim—B. \ 
res=C. pri=P 

Where: 

Key Operation 

/dev/dsk/cXdOsY Full path name of block special file where 

dynamic swap is to reside. 
mounts potnt_dir Full path name of mount_point_directory 

where the file system dynamic swap is to 

reside. 
A Integer minimum number of blocks taken 

by swap (0 = do not take any blocks at 

swapon). 
B Integer maximum number of blocks swap 

can take from file system (0 = take as 

many blocks as necessary). 
C Integer number of blocks reserved for file 

system use (0 = no reserved blocks). 
P Integer priority (0 = use dynamic swap 

space first). 
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4. Verify that dynamic swapping has been enabled: 
# /usr/hin/hdf -h 

|^0t6 Once dynamic swapping has been enabled, it cannot 

- be deactivated until swapfs lines are removed from 

Mh /etc/checklist for the section you wish to deactivate; 

«■ then reboot the system. If dynamic swapping on 

a file section was not made permanent, simply 
reboot, and all temporary swapping sections will be 
deactivated. 



Dynamic Swapping Features 

■ Dynamic swap allows paging and swapping on ordinary high 
performance file systems on an overflow basis. When dedicated 
swap section space is exhausted, dynamic swapping on enabled file 
systems begins according to a predetermined priority scheme. 

■ Dynamic swap space can be added while HP-UX is running using 
the swapon command, swapon allows the user to set sizes and limits 
to prevent dynamic swap pace from growing so large that user file 
space is critically reduced or eliminated, swapon will allocate no less 
than the minimum amount of blocks specified, but may allocate 
more for efficient use of swap space. It will not allocate blocks that 
are reserved for the file system users. 

■ Swapping performance is reduced when swapping to file systems. 
Swapping is done in file system sized blocks (typically 8K or 4K 
blocks), instead of 64K blocks used on dedicated swap sections. 
Data is scattered across the file system instead of contiguous as on 
dedicated swap sections. 

■ Once dynamic swapping is enabled on a section, it cannot be 
disabled without rebooting HP-UX. File systems with swapping 
enabled cannot be unmounted. 

■ Only one directory per file system can be specified for dynamic 
swapping. 
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ThG /etc/swapon Command 

The swapon command enables additional devices (dedicated swap 
sections) or file systems for paging and swapping. The swapon 
command and options are shown below: 

# /etc/swapon -a 

■#■ /etc/swapon name \ [directory min limit reserve priority] 

Where: 

Key Operation 

-a All dedicated swap devices (swap sections) marked 

as swap, and all dynamic swapping file systems 

marked as swapfs in /etc/checklist are made 

available for swapping. 
name Full path name of block special file of dedicated 

swap section of disk. This section must be uxgened 

into the system. 
directory Full path name of mount_point_directory of the file 

system to be enabled for dynamic swapping. 
min Integer number of file system blocks to take from 

the file system (default = 0). Only valid with 

directory option. 
limit Integer maximum number of blocks swap can take 

from the file system (default = 0). Only valid with 

directory option. 
reserve Integer number of file system blocks that are 

reserved for file system only (default = 0). Only 

valid with directory option. 
priority Integer indicates order that space is taken from the 

file systems for use as swap. Lowest priority taken 

first (default = 0). 
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Add-A-DataPair/800-Mirror-Disk Cookbook 

To create a non-LVM mirror disk using Dat.aPair/800 on a file system 
except root and swap perform the following steps: 

1. If the disk drive(s) have never been initialized, initialize the media: 
CSUtion Initialization will destroy any data on the disk drive. 



• 



# /usr/hin/mediainii /dev/diag/dsk/cXdO Where; A' — the 
logical unit (lu) number of the disk assigned by insf (for HP-UX 
versions prior to 8.0, when addressing an HP-FL device A' 
becomes 2000 + the lu number). 

2. Create an HP-UX file system on the mirrored primary and 

secondary disk sections, only if valid file system(s) do not already 
exist : 

# /eic/newfs /dev/rdsk/cXdOsY hpZZZZ 
Where: 

Key Operation 

X The logical unit (lu) number of the disk assigned by 

msf (for HP-UX versions prior to 8.0, when 
addressing an HP-FL device A' becomes 2000 4- the 
lu number). 

Y Section number of the file system to be created (see 

/etc/diskiah). 

TILTH Model number of HP disk (see /etc/disktah for 

supported models). 



3. If a mount_point_directory does not already exist for the primary 
disk section of the mirrored disk, make one using the following 
command: 

7^: /hin/mkdir /newdir 

Where: newdir is the full path name of directory the new file 
svstem is to be mounted under. 
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4. Using vi or ed, delete any existing lines in /etc /checklist that refer 
to the secondary disk section of the mirror disk pair. If a line 
does not exist for the mirrored disk primary disk section, add it 
according to the following format: 

/dev/dsk/cXdOsY /newdir hfs rw P # /newdtr 

Where: 

Key Operation 

/dev.y.OsY' Full path name of block special device file for the 

mirror disk primary disk section. 
newdir The full path name of directory the new file system 

is to be mounted under. 
hfs Section is a high performance file system. 

rw May be read or write to (default). 

Backup frequency (set to 0). 

P Integer pass number determines order that fsck 

checks file systems. 
# Begin comment field. 

5. If not already mounted, mount the mirrored disk primary disk 
section: 

if: /etc/mount -a 

Where: 

-a attempts to mount all file systems in /etc/checklist. 
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6. Mirror the primary and secondary disk sections: 

# /etc/mirror -c /dev/rdsk/cXdOsY online /dev/rdsk/cZdOsY \ 
offline 

Where: 

Key Operation 

/cXdOsY X — the primary disk logical unit number (see 

/eic/conf/gen/S800 for lu information). 

Y — section number of the primary disk. 
/cZdOsY Z = the secondary disk logical unit number (see 

/etc/conf/gen/S800 for lu information). 

Y — section number of the secondary disk (must be 
same as primary). 



7. Update the secondary disk section with an exact image of the 
primary disk section using the reimage option (this will also bring 
the secondary disk online): 

# /etc/mirror -r /dev/dsk/cXdOsY 

Where: 

Key Operation 

X The primary disk logical unit number plus 2000 

(see /etc/conf/gen/S800 for lu information). 
Y Section number of the primary disk. 



8. After the reimage has completed, verify that both sections of the 
mirror disk are now ONLINE and GOOD: 

# /etc/mirror -I 
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DataPair/800-Mirror root-and-swap Cookbook 

To create a mirror of the jvoi or swap sections, perform the following 
steps: 

1. If the disk drive(s) to be used as secondary disk section(s) for rooi 
or swap have never been initialized, initialize the media. 

CdUtion Initialization will destroy any data on the disk drive. 



• 



# /usr/bin/medtaimt /dev/diag/dsk/cXdO 

Where: A' = the logical unit (lu) number of the disk assigned 
by insf (for HP-UX versions prior to 8.0, when addressing an 
HP-FL device A' becomes 2000 -j- the lu number). 

2. Create an HP-UX file system(s) for root and/or swap mirrored 
secondary disk section(s): 

# /etc/newfs /dev/rdsk/cXdOsY hpZZZZ 
Where: 

Key Operation 

A' The logical unit (lu) number of the disk assigned by 

insf (for HP-UX versions prior to 8.0: when 
addressing an HP-FL device A" becomes 2000 -f- the 
lu number). 

Y Section number of rooi or swap file system (see 

/eic/conf/gen/SSOO for section). 

ZZZZ Model number of HP disk (see /etc/disktab for 

supported models). 
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3. Using vi or ed, edit the include section of /etc/conf/gen/SSOO. 
Uncomment the following line: 

From — 

/*include mirror;*/ 

To read — 

include mirror; 

4. Using vi or ed, edit the kernel devices section of 
/eic/conf/gen/S800 file to mirror the root section, swap section, or 
both: 

From — 

root on disc2 lu X section Y; 
swap on disc2 lu X section Z; 

To read — 

root on disc2 lu X section Y mirrored on disc2 lu W section Y; 
root on disc2 lu X section Z mirrored on dtsc2 lu V section Z; 
Where: 

Key Operation 

W root secondary disk lu number. 

1' Section number of root file system. 

V swap secondary disk lu number. 

ZY Section number of swap file system. 



Cookbook Procedures 7-25 



5. Type the following commands to make a special file for mirror disk 
and change mode, ownership, and group for the special file: 

# /etc/mknod /dev/rdsk/mirconfig c 12 OxlfOOOO 

# chmod 666 /dev/rdsk/mtrconfig 
■^ chown bin /dev/rdsk/mtrconfig 

# chgrp bin /dev/rdsk/mirconfig 

6. Follow the UXGEN Process to generate a new kernel (hp-ux). After 
a new kernel is booted, the system will mirror the root and/or swap 
file system and automatically re-image the mirrored file system(s) 
on system boot-up. 
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Modifying the LIF auto File Cool^bool^ 

1. At the ISL prompt, execute the Isautofl command. This command 
displays the content of the autoexecute file. 

2. Execute the set auiofile utility and make the desired changes. 
For example: 

ISL>hpux set auiofile (;6) hpux (2/4.0.0;13)/hp-ux 

3. Check the display message to ensure the change was correct. 

4. From the ISL> prompt, set Autoboot ON. Check Primpaih for 
proper disk path address. 

5. Reset the system. The system should automatically boot up 
without operator intervention. 
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Add-A-Conventional-File-System Cookbook 

1. Initialize the disk, if it has not been initialized: 
CdUtion Initialization destroys all data on the disk. 



t 



a^ /usr/bm/mediatnit /dev/diag/dsk/cXdO Where: 

A' = the logical unit (lu) number of the disk assigned by insf . 

2. Create an HP-UX file system with newfs: 

CSUtion Making a new file system with newfs destroys all 

• data associated with the section specified. Make 

sure you specify the correct logical unit number and 
section number when using this command. 

# /etc/newfs /dev/rdsk/cXdOsY hpZZZZ 
Where: 

Key Operation 

X Logical unit number (lu) A' assigned by tnsf . 

Y Section number of the new file system (see 

/etc/disktab). 
hpZZZZ HP disk model number (see /eic/disktab for 

supported models). 

3. Make a mount-point-directory for the new file system: 

# /bin/mkdir /neivdir 

Where : 

newdir = full path name of directory the new file system is to be 
mounted under. 
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4. Add a new line to /etc /checklist for the new file system: 

/dev/dsk/cXdOsY /newdir hfs rw P # /newdir 
Where: 

Key Operation 

/dev/./.OsY Full path name of block special device file for 
the file system to be mounted. 

/newdir Full path name of directory the new file system 

is to be mounted under. 

hfs Type (options): hfs - high performance file 

system, nfs - remote NFS file system, swap - 
swap file system, swapfs - dynamic swap file 
system, ignore - entry is ignored by mount and 
fsck. 

rw Options (use default options, or comma 

separated list of options): ro - read only, rw - 
read write (default), suid - Set-user-ID 
execution allowed (default), nosuid - 
Set-user-ID not allowed. 

Back frequency (set to 0). 

P Integer pass number P determines order fsck 

checks file systems. 

# # begins comment field. 

5. Mount new file system: 

# /etc/mount -a 

Where: 

a = Attempt to mount all file systems in /etc/checklist. 
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LVM Cookbooks 



Add An LVM Disk Cookbook 

1. Verify that the kernel has the correct drivers for the new disk 
drive. (Consult 'Installing Peripherals" if you are unsure of the 
correct drivers.) 

# Isdev 

If the correct drivers are not displayed, edit /eic/conf/gen/S800 . 
Add the necessary "include" statements, then use the UXGEN 
process to generate a new kernel. 

2. Halt the system. 

# shutdown -h 

3. Install the new hardware. Verify that there are no bus address 
conflicts. 

4. Boot the system. Once booted, use the follow^ing command to 
verify detection of the new disk drive. Note the assigned logical 
unit number for the new disk drive. 

# loscan -kfC disk 

5. Create a physical volume for LVM use. Use the logical unit 
number obtained in step 4 of this procedure for the A' in the 
command below: 

# pv create -f /dev/rdsk/cXd0s2 

Warning This will destroy any data on the disk. 



e 



6. Check dei' to see if the volume group to reside on the new disk has 
a directory under /dev. The default name for a volume group is 
vgYY where YY is the integer number of the group. 



# Is /dev I grep vg 
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7. If necessary, create a new directory under /Aev for a new volume 
group to reside on the disk. 

# mkdir /dev/vgYY 

8. If a new volume group is to be created, make a group character 
device file for the new volume group. 

# mknod /dev/vgYy'/group c 64 OxZZOOOO 
Where: 

Key Operation 

ZZ HEXADECIMAL group number. 



9. Create or extend the volume group to the new disk. Do ONE of 
the following: 

# vgcreate /dev/vgYY /dev/dsk/cXd0s2 
Which is used to create a new logical volume. 

# vgextend /dev/vgYY /dev/dsk/cXd0s2 

Which is used to extend a logical volume onto a new disk. 

10. Create a logical volume on the new disk. Specify the size of the 
logical volume to be created in megabytes following the -L option. 
The logical volume number will be the next integer not used 
(begins with 1). 

# Ivcreate -L SSS vgYY 
Where: 

Key Operation 

SSS The integer number of MB to be allocated for this 

logical volume. 
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11. Create the physical file system for the new logical volume. 
# newfs /dev/vgYY/rlvolZ MODEL 
Where: 

Key Operation 

Z The integer logical volume number. 

MODEL The HP disk's model number (see /etc/diskiab for 

supported models, and use disktnfo 
/dev/rdsk/cXd0s2 to see model number). 



12. Make a mount-point-directory on root ( / ) for the new logical 
volume. 

# mkdir /vgYYlvolZ 

13. Add a new line in /etc/checklist using vi or ed for the new logical 
volume. 

/dev/vgYY/lvolZ /vgYYlvolZ hfs rw P # /vgYYlvolZ 
Where: 

Key Operation 

/dev/vgYY The full path name of the block device file for the 

/IvolZ logical volume to be mounted. 

/vgYYlvolZ The full path name of the directory that the file 
system is to be mounted under. 

hfs Type (options): hfs - high performance file system. 

nfs - remote NFS file system, swap - swap file 
system, swapfs - dynamic swap file system, ignore - 
entry is ignored by mount and fsck. 

rw Options, (use default options, or comma separated 

list of options): ro - read only, rw - read/write 
(default), sutd - Set-user-ID execution allowed. 
nosuid - Set-user-ID not allowed. 

Backup frequency (set to 0). 

P Integer pass number P which determines the order 

in which fsck checks the file systems. 

# :^ begins the comment field. 
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14. Mount the new file system. 

# mount -a 

15. Backup the LVM data structures (PVRA and VGRA) for all 
groups affected. The default path name for the backup will be 
/e t c/lv mco nf/vg Y Y. conf . 

# vgcfgbackup /dtv/vgYY 
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LVM Example: Adding a New Disk; Volume Group; Logical 
Volumes 

The following example adds a new disk to the system. The new disk 
will be placed into a new volume group. Next, two new 100MB logical 
volumes will be created on the new disk drive. 

The commands assume the following: 

1. The new disk is HP Model Number C2474S 

2. The new disk's device files are /dev/[r]dsk/c4d0s2 

3. The new volume group is vg05 

4. The new logical volumes are Ivoll and lvol2 
The following commands w411 accomplish the task: 

# pvcreate -f /d€v/rdsk/c4d0s2 

# mkdir /dev/vg05 

# mknod /dev/vg05/group c 64 0x010000 

# vgcreaie /dev/vgOo /dev/dsk/c4dOs2 

# Ivcreate -L 100 vg05 

# Ivcreate -L 100 vg05 

# newfs /dev/vg05/rlvoll C2474S 

# newfs /dev/vg05/rlvol2 C2474S 

# mkdir /vg5lvl /vg5lv2 

# mount /dev/vgOo/lvoll /vgdlvl 

# mount /dev/vg05/lvol2 /vg5lv2 

# vgcfgbackup vg05 
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Extend An LVM Logical Volume Cookbook 

1. Determine the device files for existing physical volumes in the 
associated volume group. 

# strings /etc/lvmtab 

2. Find all physical volumes associated with the volume group that 
the logical volume to be extended resides in. Look for free space 
with the following command. 

# pvdisplay /dev/dsk/cXdOs2 
Where: 

Key Operation 

X The physical volume's logical unit number as 

indicated by strings /etc/lvmtab. 



Repeat this for each physical volume in the logical volume's volume 
group. 

Multiply the free PE extents times the PE extent size to determine 
if adequate free space is available to satisfy user space requirements. 

Note If sufficient free space is not available within 

I the volume group, use the "Add an LVM Disk 

MH Cookbook" to add a new physical volume to the 

1» volume group. Once this has been accomplished, use 

this cookbook to extend the desired logical volume. 

3. Determine the total size of the logical volume. The size in MB will 
be displayed. Note this value. It will be used in step 4 below. 

# Ivdisplay /dev/vgYY/lvolZ 

Where: 

Key Operation 

YY The integer number of the volume group associated 

with the logical volume to be extended. 
Z The target logical volume's integer number. 
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4. Extend the logical volume. 

# Ivextend -L toiaLMB^in_lvoluwe /dev/vgYY/lvolZ 
Where: 

Key Operation 

iotal_MB- Must be a larger number than that found in 
in^lvolume step 3 above. 

5. Unmount the target logical volume. 

# umount /dev/vgYY/lvolZ 
Where: 

Key Operation 

YY The integer number of the volume group associated 

with the logical volume to be extended. 
Z The target logical volume's integer number. 

6. Extend the physical file system. 

# extendfs /dev/vgYY/rlvolZ 

7. Mount the extended logical volume. 

# mount -a 

8. Backup LVM data structures (PVRA and VGRA). 

# vgcfgbackup vgYY 
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LVM Example: Extend a Logical Volume 

The following example extends a logical volume from 100 MB to 
200 MB. 

The commands assume the following: 

1. The volume group is vg05 

2. The logical volume to be extended is lvol2 

3. The logical volume is in /etc /checklist 

The following commands to accomplish the task: 

# Ivextend -L 200 /dev/vg05/hol2 

# u mount /dev/vg05/lvol2 

# extendfs /dev/vg05/rlvol2 

# mount -a 

# vgcfgbackup vg05 
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Reduce the Size of an LVM Logical Volume Cookbook 

1. Backup all user data in the logical volume to be reduced. 

(Use /backup, cpto, or tar backup utilities as appropriate or copy 
user data to another logical volume in the volume group using 
pvmove ) 

2. Unmount the logical volume to be reduced using the umouni 
command. 

# cd / ; umouni /dev/vgXX/lvolY 
Where: 

Key Operation 

A'.Y The integer number of the volume group associated 

with the logical volume to be reduced in size. 
Y The target logical volume's integer number. 

3. Determine the present total size of the logical volume to be reduced 
using Ivdisplay. This value is presented as LV Si:€ (Mbytes). 

# Ivdisplay /dev/vgXX/lvolY 

4. Reduce the size of the logical volume. 

# Ivreduce -L total_MB_in^lvolume /dev/vgXX/lvolY 
Where: 

Key Operation 

totaLMB- Must be a smaller number than that found in 
iJi-lvolume step 3. 
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5. Reduce the size of the physical file system. 

# newfs /dev/vgXX/rlvolY MODEL 

Key Operation 

Y The integer logical volume number. 

MODEL The HP disk's model number (see /etc/disktah for 

supported models, and user dtsktnfo 
/dev/rdsk/cXd0s2 to see model number). 

6. Mount the newly reduced logical volume using the mount 
command. 

# mount -a 

7. Backup LVM data structures (PVRA and VGRA). 

# vgcfgbackup /dev/vgXX 
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Remove an LVM Volume Group Cookbook 

1. Backup all user data in the volume to be removed. 

(Use fbackup, cpio or tar backup utilities as appropriate.) 

2. Determine the names of the logical volumes residing in the volume 
groups to be removed. 

# hdisplay /dev/vgXX/lvol* 
Where: 

Key Operation 

XX The integer number of the volume group associated 

with the logical volume to be reduced in size. 

3. Unmount all logical volumes in the volume group to be removed. 

# cd / ; umount /dev/vgXX/lvol* 

4. Remove the logical volumes found in step 2 from the volume group. 

# Ivremove /dev/vgXX/lvolY 

Note Multiple logical volume paths {/dev/vgXX/lvolY) 

can be included in the same Ivremove command line. 
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5. Determine if multiple physical volumes are associated with the 
volume group to be removed. This is indicated by the number of 
block device files listed for the volume group to be removed. 



# strings /etc/lvmtab 
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6. If more than one physical volume (as indicated by the number of 
block device files listed for the volume group), REMOVE ALL BUT 
ONE of the physical volumes using the vgreduce command. 

# vgreduce /dev/vgXX /dev/dsk/cYd0s2 

NotG Multiple physical volume paths {/dev/dsk/cYd0s2) 

can be included in the same vgreduce command line. 



i 



7. Now, remove the volume group. 
# vgremove /dev/vgXX 
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LVM Example: Moving A Logical Volume 

The following example moves a logical volume to a new disk that has 
more room. 

1. The volume group is vgOl 

2. The logical volume to be moved is Ivoll 

3. The physical volume associated with Ivoll is /dev/rdsk/cld0s2 

4. The destination physical volume is /dev/rdsk/c2d0s2 

The following commands will accomplish the task: 

# pvcreaie -f /dev/rdsk/c2d0s2 

# vgexiend /dev/vgOl /dev/dsk/c2d0s2 

# pvmove -n /dev/vgOl /Ivoll /dev/dsk/cld0s2 /dev/dsk/c2d0s2 

# vgcfgbackup vgOl 
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Exporting and Importing an LVM Volume Group 
Cookbook 

1. Unmount any logical volumes associated with the volume group 
you wish to export. 

# umount / dev/vgXX /Ivol* 
Where: 

Key Operation 

A'^A' The integer number of the volume group to be 

exported. 

2. Make the volume group unavailable. 

# vgchange -a n /dev/vgXX 

3. Use vgexpori to remove volume group information from 
/etc/lvmtab. 

# vgexpori -v /dev/vgXX 

4. Using VI or ed, remove any lines in /etc/ checklist that refer to 
logical volumes in the volume group to be exported. 

5. Shut the system down. 

# cd / ; shutdown -h 

6. Detach the physical disks from the exported system. Physically 
attach them to the new host system. Check the bus addresses to 
assure no conflict, power the new disk(s) on, and boot the new 
host. 

7. Create a new directory under /dev for the volume group you wish 
to import. 

# mkdir /dev/vgYY 
Where: 

Key Operation 

YY The integer number of the volume group to be 

imported. 
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8. Make a group character device file for the volume group to be 
imported. 

# mknod /dev/vgYY/group c 64 OxZZOOOO 
Where: 

Key Operation 

ZZ HEXADECIMAL group number. 

9. Determine the logical unit number(s) for the new disks to be 
imported. 

# ioscan -kfC disk 

Note the logical unit number(s). 

10. Now import the volume group. 

# vgimport -v /dev/vgYY /dev/dsk/cLd0s2 

If multiple disks, include block device file for each disk being 
imported on this line. 

Where: 

Key Operation 

YY The integer number of the volume group to be 

imported. 
I The integer logical unit number of the imported 

disk drive as displayed in step 8 above. 

11. Activate the newly imported volume group. 

# vgchange -a y /dev/vgYY 

12. Make a mount-point-directory on root ( / ) for each logical volume 
in the newly imported volume group. 

# mkdir /vgYYlvolM 
Where: 

Key Operation 

M The integer logical volume number. 
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13. Add a new line in /etc/checklist using vi or ed for the new logical 
volume(s). 

/dev/vgYY/lvolM /vgYYivolM hfs rw P # /vgYYlvolM 

Where: 

Key Operation 

/dev/vgYY The full path name of the block device file for the 

/IvolM logical volume to be mounted. 

/vgYYlvolM The full path name of the directory that the file 
system is to be mounted under. 

hfs Type (options): hfs - high performance file system, 

nfs - remote NFS file system, swap - swap file 
system, swapfs - dynamic swap file system, ignore - 
entry is ignored by mount and fsck. 

rw Options, (use default options, or comma separated 

list of options) : ro - read only, rw - read/write 
(default), suid - Set-user-ID execution allowed, 
nosuid - Set-user-ID not allowed. 

Backup frequency (set to 0). 

P Integer pass number P which determines the order 

in which fsck checks the file systems. 

# # begins the comment field. 



14. Mount the new file system(s). 
# mount -a 
Where: 

Key Operation 

a Attempts to mount everything in /etc/checklist. 



15. Backup the LVM data structures (PVRA and VGRA) for all 
groups aff"ected. The default path name for the backup will be 
/etc/lvmconf/vg Y i'. conf . 

# vgcfgbackup /dev/vgYY 
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Adding Secondary Device Swap on a Logical Volume 
Cookbook 

All physical extents used for swap (or dumps) must be contiguous, 
that is, the extents must be allocated in ascending order with no gaps 
between extents. Due to this restriction, it is rarely possible to extend 
primary swap space. 

Fortunately, adding swap space is simple. Adding swap space consists 
of creating a logical volume with contiguous extents; adding a line to 
/etc /checklist; and finally, executing the swapon command. 

Calculating the necessary swap space proves more problematic. 

A rough calculation of swap space requirements for a small standalone 
system can be made by determining the total size of the applications 
likely to be running at peak times and add this to the size of physical 
memory. A precise and detailed calculation can be made. To do this 
refer to System Administration Tasks, Appendix B, Swap Space 
Calculation. 

As a minimum, it is recommended that swap space be equal to the 
size of physical memory. 

Once the total swap size has been estimated or precisely calculated, 
proceed with the following: 

1. Determine the current state of the system's swap space. 

# swap in jo 

The output of the swapinfo command will indicate the type of swap 
by location, how much of it is available, used, and free. If hold is 
displayed, it indicates how much space the system has reserved 
based on possible requirements of running processes. 

2. If additional swap space is required, perform the first nine steps 
(when applicable) of the procedure given in Create a Logical 
Volume on a New Disk, found earlier in this section. Do NOT 
proceed beyond step 9 of this procedure. 
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3. After the applicable first nine steps of Create a Logical Volume on a 
New Disk have been performed, create a contiguous logical volume 
of sufficient size (when added to existing swap space) to bring total 
swap space to the required amount. Specify the size of the logical 
volume to be created in megabytes following the -L parameter. 

# Ivcreate -C y -L SSS vgYY 
Where: 

Key Operation 

SSS The integer number of MB to be allocated for this 

logical volume. 
YY The integer number of the volume group to create 

the logical volume in. 

4. Copy the kernel to the new logical volume. 

# cp /hp-ux /dev/vgYY/rlvolZ 

5. Add a new line in /etc/checklist using in or ed for the new logical 
volume. 

/dev/vgYY/lvolZ /swap swap defaults 

Where: 

Key Operation 

/dev/vgYY/lvolZ The full path name of the block device file for the 
new swap logical volume. 

6. Enable swapping on the new device. 

# swapon -a 
Where: 

Key Operation 

a The attempt to start swapping on everything listed 

in /etc /checklist. 
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7. Verify that the new swap device is enabled. 

# swapinfo 

8. If the a logical volume added is a member of the root volume group 
(typically vgOO), update the Boot Data Reserved Area (BDRA). 

# Ivlnboot -R /dev/vgYY 

9. Backup the LVM data structures. The default path name for the 
backup will be /etc/lvmconf/vgYY.conf . 

# vgcfgbackup /dev/vgYY 
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Adding Dumps Devices on a Logical Volume Cookbook 

Beginning with HP-UX release 9.0, you can designate non-swap disk 
partition(s) or logical volume(s) for use by the kernel to write, or 
dump, an image of the core memory after a High Priority Machine 
Check (HPMC) or kernel panic occurrence. The new disk space 
dedicated to dumps is called the dumps area. The required dumps 
area can consist of one or more disk partitions or logical volumes or a 
combination of both. 

Prior to HP-UX release 9.0, dumps were written only to designated 
swap devices. If the system was configured to save dump information, 
any bootup after a crash is forced to wait for savecore to finish saving 
the dump before swapping can be enabled. The time required to save 
a dump varies with the amount of physical memory and the state of 
the file system. Often long periods of down time result. 

The key advantage of having a dumps area is faster bootup after a 
crash. Swapping can be enabled immediately since dump information 
is not in the swap area. The key disadvantage to having a dumps area 
is that the partitions or logical volume(s) designated as dumps area(s) 
CANNOT be used for any other purpose. 

The system administrator needs to balance down time in the rare 
event of a crash against the use of disk resources. Mission critical 
systems are good candidates for configuring dumps areas. 

Please note that it is possible to still designate swap as the target for 
dump information as with past revisions of HP-UX. 

Note ■ Dumps area(s) must reside in the root volume 

I group (normally vgOO). The kernel (hp-ux) must 

Mtt know where the dumps area(s) are to use them in 

^" a crash. 

■ The logical volume(s) used as dumps area must 
have contiguous physical extents in a logical 
volume, that is, the extents must be allocated in 
ascending order with no gaps between extents. 
This must be done when the logical volume(s) are 
created with Ivcreaie. 
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To configure dumps area(s), on logical volunnes perform the following 
tasks: 

1. Verify the current system dumps area configuration. 

# Ivlnbooi -V 

This command will display the current root, swap, and dumps 
devices. 

2. If the dumps area has not been configured or if additional dumps 
area is required it will be necessary to locate or create contiguous 
logical volume(s) to be configured as dumps area. To determine if 
an existing logical volume was created in a contiguous manner use 
the Ivdtsplay command. 

# Iv display /dev/vgYY/lvolZ 

Look at the bottom line of the output. The Allocation field 
will indicate contiguous if the logical volume was created with 
contiguous physical extents. If this is not displayed, the logical 
volume cannot be used for dumps area. 

NOtG There is no way to convert a logical volume from 

I non-contiguous to contiguous. If this is desired, the 

Mtt logical volume must be removed, and if contiguous 

■T space is available on the physical volume, the logical 

volume can be created again using the Ivcreate 
-C y option as shown later in this procedure. If it 
is decided to use an existing logical volume, care 
should be taken to remove any reference to it in 
/etc/checklist. 

3. If it becomes necessary to create a contiguous logical volume for 
dumps area, perform the applicable steps among the first nine steps 
of the Create a Logical Volume on a New Disk cookbook, found 
earlier in this section. Do NOT proceed beyond step 9 of this 
procedure. 

4. After completing the applicable first nine steps of the Create a 
Logical Volume on a New Disk cookbook, create contiguous logical 
volume or volumes of sufficient size (when added to any existing 
dumps area) to bring total dumps area size to an amount which is 
at least 1 MB more than installed physical memory. 
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# Ivcreate -C y -L SSS vgYY 
Where: 

Key Operation 

SSS An integer number indicating the size in MB of 

the logical volume to be created. 

YY The integer number of the volume group the 

logical volume will be associated with. 

5. Update the Boot Data Reserved Area (BDRA) and LIF's LABEL 
file with the new dumps location(s). 

# Ivlnhooi -d /dev/vgYY/lvolZ 

NotG Repeat the command for each logical volume to be 

added as a dumps device. 
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6. Using the UXGEN process, generate a new kernel with the 
following line included in the kernel devices section of the 
/etc/conf/gen/S800 file: 

dumps on Ivol; 

Note This line may have to be added or an existing line 

- modified using vi or ed. For examples, refer to 

MH S800 — Kernel Devices and Kernel Device — Dumps 

^" located in section 1 of this manual. 

7. Now, backup the LVM data structures. The default path name for 
the backup will be /etc/lvmconf/vgYY.conf . 

# vgcfgbackup /dev/vgYY 

8. Configure /etc/rc to save dumps. Follow the procedure given in 
the Modifying /etc/rc to Save Memory Dumps, located in the 
Cookbooks section of this manual. 

9. Reboot the computer to load the new kernel into memory. 

# shutdown -r 

The system is now configured to save core images to the dumps area. 
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Booting a Damaged LVM Bootable Disk Cookbook 



ivon 





LIF Volume Header 




/4^VR>\ 




B^/C\ 




LlP^Veltfme 




VGRA 




<; 


p-ux y 




(Bad Block Poo!) 



The following procedure assumes that the Logical Interchange Format 
(LIF) sections of the bootable LVM disk is functioning to allow the 
user to load a kernel. If this is not so, use the Support Tools Media 
(Support Tape) to recover the system. 

1. Attempt to boot the disk in LVM maintenance mode. 

ISL> hpux -Im (BC/X.Y.Z.U;OJhp-ux (try SYSBCKUP too) 

Where BC/X.Y.Z.U is the physical path to the boot disk. 

The steps that follow will not apply in all situations, nor will the 
order of the commands presented be applicable in all cases. The 
user must read and analyze error messages to arrive at a solution. 

If the following general troubleshooting suggestions fail to remedy 
the bootup problem, refer to Solving HP-UX Problems, HP Part 
Number B2355-90030, Chapter 8, or call HP for expert assistance. 
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The following assumptions will apply to the commands that follow; 
the root volume group is vgOO; and the root logical volume is Ivoll . 
If this is not the case, substitute your system's root volume group 
and root logical volume when typing the commands. 

The key things to accomplish are: 

a. Restore or update LVM data structures. 

b. Make the root volume group available. 

2. Use vgcfgresiore to restore a current backup of LVM data 
structures (PVRA, VGRA, and BDRA) to vgOO. 

# vgcfgresiore -n vgOO /dev/rdsk/cX d0s2 

Where: A' is the logical unit number of the root disk. 

3. Attempt to make the root volume group available. 

# vgchange -a y /dev/vgOO 

4. The following will update LIF's LABEL file with information 
contained in the Boot Data Reserve Area. 

# Ivlnhoot -R /dev/vgOO 

5. Make sure all LVM disks are powered, then use vgscan to rebuild 
the /etc/lvmtab file. Many LVM commands depend on the 
information contained in this file. 

# mv /etc/lvmtab /etc/lvmiab.bk 

# vgscan -v 

Once the root volume group LVM data structures have been 
replaced or updated and the volume group is available, the system 
should boot normally. 
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LVM Example: Mirroring a Root Disk 

The following example will create a single mirror for the root and 
primary swap logical volumes. The commands assume the following: 

1. The root volume group is vgOO 

2. The root logical volume is Ivoll 

3. The primary swap device is lvol2 

4. The root bootable system disk is LU 

5. The mirror copy disk is LU 1 

The following commands will accomplish the task: 

# pvcreate -B /dev/rdsk/cld0s2 

# mkboot -/ /dev/rdsk/cld0s2 

# mkboot -a "hpux (;0)/hp-ux'' /dev/rdsk/cld0s2 

# vgextend /dev/vgOO /dev/dsk/cld0s2 

# Ivextend -ml /dev/vgOO/lvoll /dev/dsk/cld0s2 

# Ivextend -m 1 /dev/vg00/lvol2 /dev/dsk/cld0s2 

# Ivlnboot -r /dev/vgOO/lvoU 

# Ivlnboot -s /dev/vgOO/lvol2 

# vgcfgbackup vgOO 
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LVM Example: Backup Up the Mirrored Disk 

The following example will split the root mirror created in the 
previous example, back up the data, and merge the two logical 
volumes back into the mirror. 

Here are the commands to accomplish the backup and 
resynchronization; 

# Ivsplit -s backup /dev/vgOO/lvoU 

# fsck -p /dev/vgOO/lvoll backup 

# mkdir /Ivoll backup 

# mount /dev/vgOO/lvoll backup /Ivol J backup 
# /backup -f /dev/rmt/Oh -OvHi /IvoUbackup 

# umount /IvoUbackup 

# Ivmerge /dev/vgOO /IvoUbackup /dev/vgOO/lvoU 

# vgcfgbackup vgOO 
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A 



Other HP-UX Information Sources 



Reference Publications 



Title 



HP Part 
Number 



HP-UX Reference (3- volume set) B2355-90033 

Advanced UNIX Programming (Prentice-Hall, 1985) 92453-90007 

Installing and Updating HP-UX B3108-90006 

HP-UX System Administration Tasks Manual, HP B3105-90005 
9000 Series 800 

Finding HP-UX Information, HP 9000 Series 800 B3108-90001 

HP-UX VI Reference Card 98597-90000 

Error Message Catalog B 1862-90004 

Support Tools User's Manual 5961-1612 

Managing Disk Mirrors Using DataPair/800 92453-90023 

Managing SwitchOver/UX 92668-90005 

Solving HP-UX Problems B2355-90030 

HP GlancePlus/UX User's Manual B2660-90001 

Installing Peripherals HP 9000 Series 800 Computers B3108-90004 
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GSY Information Database System 

The GSY Server Mail Information Database System (GSYINFO) is 
available to the on-line community, and provides a way to obtain and 
exchange various types of information, including programs, documents, 
and interesting articles. 

To access GSYINFO, use either: 

■ From HP Desk, at address GSYINFO/HP4IOO 

or 

■ From HP-UX systems, at address gsyinfo@hpcugsya 
GSYINFO is easy to use, and has only a few basic rules. These are: 

1. Your message subject can be anything you choose. 

2. Commands (listed below) must be in the body (or text) portion of 
the message. 



Commands 



Command 



Description 



comment All lines following this are mailed in a separate 

message to the Server Administrator. You may use 
comment to send Server bug reports, enhancement 
requests, or use this feature to submit new 
information to the database. 

find pattern Returns a list of files that match pattern. You may 

then use the send command to have any of these 
files mailed to you. 

grep pattern Returns a list of files that contain pattern in them, 

by doing a case- insensitive search. You may then 
use the send command to have any of these files 
mailed to vou. 
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Commands, cont. 

Command Description 



help Returns help information (this list). When you 

receive this message from the Server you will be 
able to select specific help topics by entering an 
asterisk (*) before the pathname of the topic(s) and 
then mailing this message back to the Server. Your 
selection(s) will be mailed back to you in 
subsequent mail message(s). (See send below). 

run This command allows you to run specific programs 

and have the results of program execution mailed 
to you. Some programs may require that you send 
a template to the Server so that the necessary 
information can be provided to the program you 
wish to execute. 

send [shar] index is an alias for send. Returns a complete list 

of files that can be mailed to you, or use this 
command to have specific files mailed to you. 
When you receive the send message from the 
Server, you will be able to select specific files by 
entering an asterisk (*) before their pathname(s) 
and then mailing the message back to the Server. 
Your selection(s) will be mailed to you in 
subsequent mail message(s). If you use the [shar] 
option, all the files that you have requested will be 
"shar"ed, and then mailed to you. 
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fbackup command, 1-69 
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file system, 6-2-24 
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H 

history command, 1-35-38 
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moving logical volume example, 
7-42 

N 

new disk, 6-2-13 
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shutdown, system, 1-60 
space, MINFREE/system, 6-17 
special files and HP-UX, 1-101 
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startup, HP-UX, 1-50 
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update 
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mounting file systems, 2-39 
removing files, 2-39 
removing filesets, 2-41 
symbolic links, creating, 2-39 
TOOL fileset, 2-34 
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